{"id":41660744,"url":"https://github.com/devobsessed/code-captain","last_synced_at":"2026-01-24T17:00:40.532Z","repository":{"id":308791810,"uuid":"1030033889","full_name":"devobsessed/code-captain","owner":"devobsessed","description":"Code Captain is an intelligent AI development workflow system that guides you through requirements gathering, planning, implementation, and project management. ","archived":false,"fork":false,"pushed_at":"2025-12-17T14:46:40.000Z","size":600,"stargazers_count":7,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-21T03:00:02.617Z","etag":null,"topics":["agent","ai","claude-code","copilot","cursor","developer-tools","prompt-engineering","windsurf"],"latest_commit_sha":null,"homepage":"https://www.devobsessed.com/ai","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devobsessed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-01T01:41:57.000Z","updated_at":"2025-12-17T14:46:45.000Z","dependencies_parsed_at":"2025-09-27T16:15:42.741Z","dependency_job_id":null,"html_url":"https://github.com/devobsessed/code-captain","commit_stats":null,"previous_names":["devobsessed/code-captain"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devobsessed/code-captain","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devobsessed%2Fcode-captain","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devobsessed%2Fcode-captain/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devobsessed%2Fcode-captain/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devobsessed%2Fcode-captain/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devobsessed","download_url":"https://codeload.github.com/devobsessed/code-captain/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devobsessed%2Fcode-captain/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","claude-code","copilot","cursor","developer-tools","prompt-engineering","windsurf"],"created_at":"2026-01-24T17:00:32.728Z","updated_at":"2026-01-24T17:00:40.503Z","avatar_url":"https://github.com/devobsessed.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Code Captain: AI Development Partner\n\n\u003e **Your comprehensive AI coding assistant for the complete development lifecycle**\n\nCode Captain is an intelligent development workflow system that guides you through requirements gathering, planning, implementation, and project management. Think of it as your senior technical lead who can analyze requirements, design systems, implement features, and coordinate with external project management tools.\n\n## 🎯 What is Code Captain?\n\nCode Captain transforms how you work with AI development assistants by providing:\n\n- **📋 Systematic Workflows** - Structured approaches to common development tasks\n- **🏗️ Complete Lifecycle Coverage** - From requirements to deployment\n- **🔍 Documentation \u0026 Tracking** - Organized outputs and progress tracking\n- **📚 Organized Documentation** - Everything has its place and purpose\n\nInstead of ad-hoc AI prompting, Code Captain provides proven workflows for:\n\n- **Requirements \u0026 Planning** - Specifications, user stories, research, and architectural decisions\n- **Implementation** - Test-driven development with progress tracking\n- **Project Management** - Seamless integration with external tools\n- **Documentation** - Comprehensive, organized outputs\n\n## 🚀 Quick Installation\n\n**Cross-platform interactive installer:**\n\n```bash\nnpx @devobsessed/code-captain\n```\n\nThe installer will:\n\n- 🔍 Auto-detect your development environment\n- 🎯 Install the appropriate Code Captain integration\n- 📦 Set up the complete workflow system\n- ✅ Configure everything for immediate use\n\n**Requirements:** Node.js 16 or higher\n\n## 🛠️ Supported Development Environments\n\nCode Captain integrates with multiple AI-powered development environments. Choose your platform:\n\n### [Cursor IDE](cursor/README.md)\n\n_AI-first development with built-in agent system_\n\n- Native `.cursor/rules/` integration\n- Command recognition and auto-completion\n- Seamless workflow execution\n- **→ [Cursor Setup Guide](cursor/README.md)**\n\n### [GitHub Copilot + VS Code](copilot/README.md)\n\n_Classic VS Code with Copilot Chat integration_\n\n- Custom chat modes and prompts\n- `.github/` repository integration\n- Team collaboration features\n- **→ [Copilot Setup Guide](copilot/README.md)**\n\n### [Claude.dev](claude-code/README.md)\n\n_VS Code extension for Claude integration_\n\n- Direct Claude API integration\n- Custom agent configurations\n- Flexible workflow execution\n- **→ [Claude.dev Setup Guide](claude-code/README.md)**\n\n## 🎮 Core Commands (All Platforms)\n\n### 📋 Project Setup \u0026 Analysis\n\n- **`initialize`** - Analyze and set up project documentation\n- **`plan-product \"idea\"`** - Comprehensive product planning\n- **`research \"topic\"`** - Systematic technical research\n- **`new-command \"name\" \"desc\"`** - Extend Code Captain\n\n### 📝 Requirements \u0026 Planning\n\n- **`create-spec \"feature\"`** - Feature specifications with technical details\n- **`edit-spec [id] \"changes\"`** - Modify existing specifications\n- **`create-adr \"decision\"`** - Architecture Decision Records with research\n- **`explain-code [target]`** - Code explanations with diagrams\n\n### ⚙️ Implementation\n\n- **`execute-task`** - Test-driven development workflow\n- **`status`** - Comprehensive project status\n- **`swab`** - Small code improvements\n\n_Command syntax and execution varies by IDE - see platform-specific documentation_\n\n## 🔄 Workflow Examples\n\n### Feature Development\n\n```bash\n# 1. Research and plan\n/research \"WebSocket vs Server-Sent Events\"\n/create-adr \"real-time communication strategy\"\n\n# 2. Create comprehensive specification\n/create-spec \"real-time chat system\"\n\n# 3. Implement with TDD\n/execute-task\n```\n\n### Project Analysis\n\n```bash\n# Analyze existing codebase\n/initialize\n\n# Plan new features based on analysis\n/plan-product \"enhanced user dashboard\"\n\n# Clean up as you go\n/swab\n```\n\n## 📁 Directory Structure\n\nAfter installation, Code Captain creates an organized workspace:\n\n```\n.code-captain/\n├── commands/            # All available commands\n├── docs/               # Generated documentation\n├── research/           # Technical research reports\n├── decision-records/   # Architecture Decision Records\n├── specs/              # Feature specifications\n└── cc.md              # Complete reference guide\n```\n\nPlus IDE-specific integration files in:\n\n- `.cursor/rules/` (Cursor)\n- `.github/` (Copilot)\n- `.claude/` (Claude.dev)\n\n## 🔧 Platform-Specific Setup\n\nEach development environment has its own setup process and command syntax:\n\n| Platform       | Installation Location | Command Format | Documentation                             |\n| -------------- | --------------------- | -------------- | ----------------------------------------- |\n| **Cursor**     | `.cursor/commands/`   | `/command`     | [Cursor Guide](cursor/README.md)          |\n| **Copilot**    | `.github/`            | `/command`     | [Copilot Guide](copilot/README.md)        |\n| **Claude.dev** | `.claude/`            | `/command`     | [Claude.dev Guide](claude-code/README.md) |\n\n## 🚀 Key Advantages\n\n### vs. Manual AI Prompting\n\n- ✅ **Systematic workflows** vs. ad-hoc requests\n- ✅ **Organized documentation** vs. scattered outputs\n- ✅ **Project management integration** vs. isolated interactions\n- ✅ **Progress tracking** vs. manual status management\n\n### vs. Traditional Development Tools\n\n- ✅ **AI-powered planning** vs. manual specification creation\n- ✅ **Integrated TDD workflow** vs. separate testing processes\n- ✅ **Automatic issue creation** vs. manual project management setup\n- ✅ **Comprehensive documentation** vs. minimal or missing docs\n\n## 🛠 Development \u0026 Customization\n\n### Local Development\n\n```bash\n# Clone and test locally\ngit clone https://github.com/devobsessed/code-captain.git\ncd code-captain\n\n# Install from local source\nCC_LOCAL_SOURCE=. npx @devobsessed/code-captain\n```\n\n### Adding Platform Support\n\n1. Create `platform-name/` directory\n2. Add platform-specific commands and documentation\n3. Update installer platform detection\n4. Create platform-specific README\n\n## 🔮 Roadmap\n\n- **Additional Platforms** - Neovim, Emacs, JetBrains IDEs\n- **Enhanced Templates** - More workflows and automation\n- **Team Collaboration** - Multi-developer coordination\n- **Enterprise Features** - Organization-wide standards\n\n## 🤝 Contributing\n\n1. **Fork the repository**\n2. **Choose your platform** - Add support for new IDEs or enhance existing ones\n3. **Follow existing patterns** - Command structure, documentation, installation\n4. **Test thoroughly** - Verify installer and platform integration\n5. **Submit pull request** - Include platform-specific documentation\n\n---\n\n**Transform your development process with intelligent, organized workflows.**\n\n**Ready to get started?**\n\n1. **Install:** `npx @devobsessed/code-captain`\n2. **Choose your IDE** from the links above\n3. **Begin with:** `/initialize`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevobsessed%2Fcode-captain","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevobsessed%2Fcode-captain","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevobsessed%2Fcode-captain/lists"}