{
  "markdown": "# Dev Flow — Gemini CLI Extension\n\n<!-- Badges -->\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Gemini CLI Extension](https://img.shields.io/badge/Gemini%20CLI-Extension-green.svg)](https://github.com/google-gemini/gemini-cli)\n[![Version](https://img.shields.io/github/v/release/shrwnsan/clix-dev-flow)](https://github.com/shrwnsan/clix-dev-flow/releases)\n[![Issues](https://img.shields.io/github/issues/shrwnsan/clix-dev-flow)](https://github.com/shrwnsan/clix-dev-flow/issues)\n\n## Overview\n\nDev Flow is a simple Gemini CLI extension that brings AI development workflow patterns to your terminal. It helps you plan, design, and implement features through systematic commands with AI assistance.\n\n**📚 Documentation:**\n- [GEMINI.md](./GEMINI.md) - Gemini CLI specific context\n- [AGENTS.md](./AGENTS.md) - AI agent guidelines\n- [EXAMPLES.md](./EXAMPLES.md) - Usage examples\n\n## Features\n\n- **AI Workflow Patterns**: Plan → Design → Build with clear checkpoints\n- **Smart Task Management**: Automatic progress tracking and validation\n- **Utility Commands**: List PRDs, track progress, and clean up completed work\n- **Git Integration**: Conventional commits with detailed messages\n\n## Installation\n\n### Official Method (Recommended)\n\nInstall the extension directly from GitHub:\n```bash\ngemini extensions install https://github.com/shrwnsan/clix-dev-flow.git\n```\n\nRestart Gemini CLI to load the extension.\n\n### Development Method\n\nFor development or to access the latest changes:\n```bash\ngit clone https://github.com/shrwnsan/clix-dev-flow.git\ncd clix-dev-flow\ngemini extensions install .\n```\n\nRestart Gemini CLI to load the extension.\n\n**Compatibility:** Gemini CLI (v0.8.2 or higher)\n\n## Quick Start\n\n```bash\n# 1. Plan a feature\n/dev:create-prd \"Create user authentication system\"\n\n# 2. Generate implementation tasks\n/dev:generate-tasks \"0001-prd-user-authentication-system\"\n\n# 3. Build step by step\n/dev:process-task-list \"tasks-0001-prd-user-authentication-system\"\n```\n\n## Commands\n\n### Core Workflow\n\n**`/dev:create-prd`** - Generate feature planning documents\n```bash\n/dev:create-prd \"brief description of your feature\"\n```\n\n**`/dev:generate-tasks`** - Create detailed task breakdowns\n```bash\n/dev:generate-tasks \"filename-or-path-to-prd-file\"\n```\n\n**`/dev:process-task-list`** - Execute implementation tasks\n```bash\n/dev:process-task-list \"filename-or-path-to-task-list\"\n```\n\n### Utilities\n\n**`/dev:list-prds`** - List all planning documents\n**`/dev:list-tasks`** - Show task progress\n**`/dev:cleanup`** - Manage completed work\n\n## File Structure\n\n```\nyour-project/\n├── tasks/\n│   ├── 0001-prd-feature-name.md          # Generated PRDs\n│   ├── tasks-0001-prd-feature-name.md    # Generated task lists\n│   └── completed/                        # Archived work\n└── .gemini/extensions/dev-flow/          # Extension files\n```\n\n## FAQ / Troubleshooting\n\n**Extension not loading?**\n- Ensure proper installation: `gemini extensions install .`\n- Restart Gemini CLI after installation\n- Check `gemini-extension.json` syntax\n\n**Commands not found?**\n- Check that extension is enabled: `gemini extensions enable dev-flow`\n- Verify command files exist in `commands/dev/` directory\n- Restart Gemini CLI\n\n**File permission errors?**\n- Ensure write permissions in project directory\n- Check that `/tasks` directory can be created\n- Run `chmod 755 .` if needed\n\n**Missing directories?**\n- Commands automatically create the `/tasks` directory\n- If auto-creation fails, create manually: `mkdir tasks`\n\n## Contributing\n\nContributions are welcome! Fork the repository, create a feature branch, and open a Pull Request.\n\n### Development Setup\n1. Fork and clone the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes and push to the branch\n4. Open a Pull Request\n\n### Issue Reporting\nFor bug reports or feature requests:\n- Include a clear description of the issue\n- Provide steps to reproduce (for bugs)\n- Include your environment details (OS, Gemini CLI version)\n- Add relevant logs or screenshots if available\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](./LICENSE) file for details.\n\n## Attribution\n\nThis project is derived from [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) by Ryan Carson, licensed under Apache-2.0.\n\nThe ai-dev-tasks project is one of few notable ones pioneering structured approaches to human-AI collaboration in software development, including systematic AI agent orchestration patterns that have been adapted for use as a Gemini CLI extension.\n\n---\n\n⭐ **Star this repository** if you find Dev Flow helpful!",
  "bytes": 4707,
  "sha": "92ca11f68484a32a3e6173c97cc564dd082ae9ec153d52b5bc4ec1e14ed75e8b",
  "repo_slug": "shrwnsan/clix-dev-flow",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_shrwnsan_clix_dev_flow_26ff3308/readme"
}