{
  "markdown": "# Blueprint Extension for Gemini CLI\n\nThis extension provides a collection of commands giving you a structured and robust workflow for tackling complex software engineering tasks directly within Gemini CLI.\n\nThis workflow is designed to guide you from the initial research and planning stages all the way through implementation, following a PLAN ➡️  DEFINE ➡️  ACT loop.\n\n## ✨ Features\n\nThe workflow is built around a few core ideas:\n\n*   **Step-by-Step Process:** Each command corresponds to a specific phase of a development task. You move from one step to the next, with each command building on the output of the last.\n*   **Stateful Tracking:** The workflow uses a series of markdown files (e.g., `PLAN.md`, `TODO.md`, `ACT.md`) to track the state of your task. This allows you to pause and resume your work without losing context.\n*   **User Approval:** The workflow emphasizes safety and collaboration. For any significant action, such as creating a plan or fixing a bug, Gemini will present its proposed changes for your approval before proceeding.\n\n## 🚀 Installation\n\nUse the `gemini extensions install` command to install directly from the source repository:\n\n```bash\ngemini extensions install https://github.com/gplasky/gemini-cli-blueprint-extension.git --auto-update\n```\n\nThe `--auto-update` is optional: if specified, it will update to new versions as they are released.\n\nYou can manage the extension with the following commands:\n\n```bash\n# Update to the latest version\ngemini extensions update blueprint\n\n# Uninstall the extension\ngemini extensions uninstall blueprint\n```\n\n## 🛠️ Available Commands\n\nThis extension provides the following commands.\n\n### Primary Commands\n\n*   **/blueprint:research**: Searches for information on a topic.\n*   **/blueprint:plan**: Creates a plan to accomplish your goal.\n*   **/blueprint:define**: For the given plan, defines the specific tasks to achieve the goal.\n*   **/blueprint:implement**: Implements a plan by executing defined tasks.\n*   **/blueprint:test**: Tests the plan's implementation to verify it meets the requirements.\n*   **/blueprint:refine**: Refines any part of the workflow based on user feedback or test failures.\n\n### Utility Commands\n\n*   **/blueprint:resume**: Resumes an interrupted workflow by automatically determining the last completed step.\n*   **/blueprint:clear**: Clears the workspace of all workflow-generated markdown files.\n\n\n## 💡 Usage\n\nThe typical workflow follows this sequence:\n\n1.  **/blueprint:research**: Gather initial information and context.\n2.  **/blueprint:plan**: Create a high-level, step-by-step plan.\n3.  **/blueprint:define**: Break the plan down into a detailed `TODO.md` list.\n4.  **/blueprint:implement**: Execute the tasks in the `TODO.md` list.\n5.  **/blueprint:test**: Verify the implementation against the plan.\n\n**Optional:**\n\n*   **/blueprint:refine**: Iterate on any part of the workflow based on test results or your feedback.\n\n```mermaid\nstateDiagram-v2\n    [*] --> Idle\n    Idle --> Researching: /blueprint#58;research\n    Researching --> Planning: /blueprint#58;plan\n    Planning --> Defining: /blueprint#58;define\n    Defining --> Implementing: /blueprint#58;implement\n    Implementing --> Testing: /blueprint#58;test\n    Testing --> [*]: 'Success'\n    Testing --> Planning: /blueprint#58;refine\n```\n\n## ✅ Getting Started\n\nTo start a new task, simply invoke the first command in the workflow that makes sense for your needs. For a brand new feature, you might start with `/blueprint:research` or, more commonly, `/blueprint:plan`.\n\n```\n/blueprint:plan add a new authentication endpoint\n```\n\nGemini will then guide you through the subsequent steps. If you get interrupted, you can always come back and run `/blueprint:resume` to pick up right where you left off.\n",
  "bytes": 3781,
  "sha": "f866a543798030577ca6ecfff2a55c2d271c039164b0fff1e6028da3cb4c4558",
  "repo_slug": "gplasky/gemini-cli-blueprint-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gplasky_gemini_cli_blueprint_extension_2b57c8b0/readme"
}