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
Plugin

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
All reasons and checks

opensqz/gtplanner

Install

Manual install

cd ~/.claude/plugins
git clone https://github.com/OpenSQZ/GTPlanner.git

The first step of the Claude Code Skill section in the README. Then `.env` from `.env.example` and `/gtplanner-init`.

Access and checks

How we review

Extended 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.

Plugins

A Claude Code plugin with stage commands from PRD and design to implementation, acceptance and release on Rust and React.

PluginBroad access106Repository stars

planr keeps agent-driven development tasks in Git Markdown files and shows what is ready, blocked and waiting on you

PluginMinimal access74Repository stars

A Claude Code plugin that interviews you, designs the architecture and writes a self-contained blueprint to build from

PluginMinimal access580Repository stars

A plugin that turns Claude Code into a 16 agent team: documentation first planning, TDD and 9 pre-merge quality gates.

PluginBroad access53Repository stars

A Claude Code plugin links planning, implementation and task checks, retains progress and controls how independently agents work.

PluginBroad access605Repository stars

This skill set assembles a Product Requirement Prompt: the goal, file paths, code examples and validation commands for an agent.

SkillMinimal access2.3KRepository stars

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`.

README badge

Report a problem