GTPlanner plugin
GTPlanner turns a task description into a PRD and design document: planning, stack choice and design docs inside Claude Code.
- 314 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The project description goes to the chosen model provider and to Jina in the research step
- The plugin runs Python code from a cloned repository
Install
- Works in
Manual install
cd ~/.claude/plugins
git clone https://github.com/OpenSQZ/GTPlanner.gitThe first step of the Claude Code Skill section in the README. Then `.env` from `.env.example` and `/gtplanner-init`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The project description goes to the chosen model provider and to Jina in the research step
- The plugin runs Python code from a cloned repository
This is third-party code. Review the repository files before installing.
What it does
GTPlanner takes a plain-language product description and produces structured documentation for a coding agent. In Claude Code the plugin is added as a skill with the `/gtplanner-init` command and reacts to words such as PRD, architecture and technical design. Work goes through four tools: `short_planning` clarifies the task and scope, `tool_recommend` proposes a stack, `research` gathers material (needs `JINA_API_KEY`) and `design` writes the design document in quick or deep mode. There is also a web UI, a console mode, a FastAPI service and MCP access.
Who it is for. Developers and founders who hand a project to a coding agent and want a PRD, stack and design document first.
Good fit when
- The idea fits in a couple of paragraphs and the agent needs a fully written brief.
- Before a project starts, technology options are compared and a short recommendation is wanted.
- A `design.md` with architecture and modules is being prepared for Cursor or Claude Code.
- The specification has to come out in English, Chinese, Japanese, Spanish or French.
Not a fit when
- The task is already specified and only code remains.
- Requests must not go to an external model provider.
- There is no Python 3.10 environment with the `uv` package manager and you do not want to set it up.
Example request
Design a service that watches GitHub issues, scores sentiment and applies labels, and produce a PRD with a stack recommendation.Limitations
The plugin is installed by cloning into `~/.claude/plugins`, then you need Python 3.10 or newer, `uv` and an `.env` file with `LLM_API_KEY`, `LLM_BASE_URL` and `LLM_MODEL`. User requirements go to the chosen model provider, and the `research` step also calls Jina. Document quality depends on the chosen model: read the result as a draft, not as a finished specification. The README gives examples in English and Chinese, the plugin claims five languages, and Russian is not among them.
How to disable. Delete the `~/.claude/plugins/GTPlanner` folder and restart Claude Code. The `.env` file with the key lives inside that folder, and generated documents stay wherever you saved them.
FAQ
Which tools does the plugin include?
Four: `short_planning` for requirements analysis, `tool_recommend` for stack choice, `research` for technical research and `design` for the design document in quick or deep mode.
Which variables are required to run it?
`LLM_API_KEY`, `LLM_BASE_URL` and `LLM_MODEL` in `.env`. The `research` step also needs `JINA_API_KEY`.
How do I run it without Claude Code?
Through the console: `python gtplanner.py` opens a dialog and `python gtplanner.py "description"` runs a single request. There is also a FastAPI service: `uv run fastapi_main.py` listens on port 11211.
Can I use it without installing?
Yes, the project has a web version at the-agent-builder.com with the same planning flow.
Does it work with Cursor?
Yes, through MCP. Connection details are in `mcp/README.md` in the repository.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin with stage commands from PRD and design to implementation, acceptance and release on Rust and React.
planr keeps agent-driven development tasks in Git Markdown files and shows what is ready, blocked and waiting on you
A Claude Code plugin that interviews you, designs the architecture and writes a self-contained blueprint to build from
A plugin that turns Claude Code into a 16 agent team: documentation first planning, TDD and 9 pre-merge quality gates.
A Claude Code plugin links planning, implementation and task checks, retains progress and controls how independently agents work.
PRP (Product Requirement Prompts)
PRPs-agentic-eng
This skill set assembles a Product Requirement Prompt: the goal, file paths, code examples and validation commands for an agent.
README in short
The project idea is to give an agent a work description, a tool list and a skeleton before coding. The output lands in `design.md` and `prefab.md`.