{"_id":"@ansarullahanas/cc-guide","_rev":"2-b502bbd744ebd84de25c8cda00ac0f0a","name":"@ansarullahanas/cc-guide","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@ansarullahanas/cc-guide","version":"1.0.0","keywords":["claude","claude-code","ai","prd","ralph-tui","autonomous","development"],"author":"","license":"MIT","_id":"@ansarullahanas/cc-guide@1.0.0","maintainers":[{"name":"ansarullahanas","email":"ansar@z360.biz"}],"homepage":"https://github.com/ansarali41/cc-guide#readme","bugs":{"url":"https://github.com/ansarali41/cc-guide/issues"},"bin":{"cc-guide":"bin/add-skill.js"},"dist":{"shasum":"c70605f583698bbcb99b2b59ea817e78444a9301","tarball":"https://registry.npmjs.org/@ansarullahanas/cc-guide/-/cc-guide-1.0.0.tgz","fileCount":59,"integrity":"sha512-dqGKO0j5qxvFUxJyHT58jDGYm+IkP4EWjXDmiEwK1aB3qw0H17e1iupeBGjPtiTtG0odOSNvZOGG74uqmFxTLQ==","signatures":[{"sig":"MEQCIBkBa1XO820pANHxcK3DXNugNA3bwhQYkzDFfxLYO0boAiAHakEOy/pMdIZoaTL4FHLztiGecAnbj1lntX8wM+BHug==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":355155},"main":"index.js","gitHead":"159527890c8d29dc85885d075abd812902bb116b","scripts":{"add-skill":"node bin/add-skill.js"},"_npmUser":{"name":"ansarullahanas","email":"ansar@z360.biz"},"repository":{"url":"git+https://github.com/ansarali41/cc-guide.git","type":"git"},"_npmVersion":"11.6.2","description":"Claude Code skills and guides for autonomous AI-assisted development","directories":{},"_nodeVersion":"23.10.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cc-guide_1.0.0_1769038694454_0.6692681213320066","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ansarullahanas/cc-guide","version":"1.0.1","description":"Claude Code skills and guides for autonomous AI-assisted development","main":"index.js","bin":{"cc-guide":"bin/add-skill.js"},"scripts":{"add-skill":"node bin/add-skill.js"},"keywords":["claude","claude-code","ai","prd","ralph-tui","autonomous","development"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/AnsarUllahAnasZ360/cc-guide.git"},"homepage":"https://github.com/AnsarUllahAnasZ360/cc-guide#readme","gitHead":"159527890c8d29dc85885d075abd812902bb116b","_id":"@ansarullahanas/cc-guide@1.0.1","bugs":{"url":"https://github.com/AnsarUllahAnasZ360/cc-guide/issues"},"_nodeVersion":"23.10.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-FVb3F9OgQH9PThbhiH5+EPOETTSWNUWFOGtoWZfBsic9R4kDKHqKv5IZYu4vH/2s3viLK6tmA6TqNCODdzGSmQ==","shasum":"77dcfa38ff94e5b94032f7bcc583bdb660989b5f","tarball":"https://registry.npmjs.org/@ansarullahanas/cc-guide/-/cc-guide-1.0.1.tgz","fileCount":59,"unpackedSize":355258,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFjTIpFhMj1nQm8YHUAeirJ/cYR72cQxiS+548zpkN+iAiEAjop1ZiGxnP3BoQvC+VYt+zK4xYkGPpi9Aass0CB7I9Q="}]},"_npmUser":{"name":"ansarullahanas","email":"ansar@z360.biz"},"directories":{},"maintainers":[{"name":"ansarullahanas","email":"ansar@z360.biz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cc-guide_1.0.1_1769038827713_0.2274905748680527"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-21T23:38:14.345Z","modified":"2026-01-21T23:40:27.974Z","1.0.0":"2026-01-21T23:38:14.595Z","1.0.1":"2026-01-21T23:40:27.858Z"},"bugs":{"url":"https://github.com/AnsarUllahAnasZ360/cc-guide/issues"},"license":"MIT","homepage":"https://github.com/AnsarUllahAnasZ360/cc-guide#readme","keywords":["claude","claude-code","ai","prd","ralph-tui","autonomous","development"],"repository":{"type":"git","url":"git+https://github.com/AnsarUllahAnasZ360/cc-guide.git"},"description":"Claude Code skills and guides for autonomous AI-assisted development","maintainers":[{"name":"ansarullahanas","email":"ansar@z360.biz"}],"readme":"# Claude Code Guide\n\nSkills and guides for autonomous AI-assisted development with Claude Code and Ralph loops.\n\n## What This Is\n\nThree skills you can add to any project:\n- **`prd`** - Create PRDs that Claude can execute autonomously\n- **`setup-claude`** - Initialize or audit repositories for optimal Claude Code usage\n- **`agent-browser`** - Headless browser automation and E2E testing\n\nPlus guides on how I actually use Claude Code.\n\n## Quick Start\n\n### Add Skills to Your Project\n\n```bash\n# Add the PRD skill\nnpx cc-guide add-skill prd\n\n# Add the setup/audit skill\nnpx cc-guide add-skill setup-claude\n\n# Add the browser automation skill\nnpx cc-guide add-skill agent-browser\n\n# Or add all skills\nnpx cc-guide add-skill --all\n```\n\nThis copies the skills to your project's `.claude/skills/` folder.\n\n### Use the Skills\n\nIn Claude Code:\n\n```\n/prd                    # Create a PRD for a new feature\n/setup-claude init      # Set up a new repository\n/setup-claude audit     # Audit an existing repository\n```\n\n## The Idea\n\nTraditional: You code, AI helps, you iterate forever.\n\nThis way: You define the work, AI executes, you review.\n\n```\nTraditional:          Ralph Loop:\nHuman → AI → Human    Human → PRD → AI Loop → Human Review\n     ↑      ↓              ↓           ↓\n     └──────┘          (autonomous)  (complete)\n```\n\n**The quality of your PRD determines the quality of your output.**\n\n## What You Need\n\n| Tool | Install | Why |\n|------|---------|-----|\n| Claude Code | [claude.ai/claude-code](https://claude.ai/claude-code) | Core CLI |\n| GitHub CLI | `brew install gh` | Git operations |\n| tmux | `brew install tmux` | Persistent sessions |\n| Ralph TUI | `npm install -g ralph-tui` | Task orchestration |\n| Agent Browser | `npm install -g agent-browser` | Browser automation |\n\n## Guides\n\n- [My Claude Workflow](./guides/my-claude-workflow.md) - How I actually use Claude Code\n- [Ralph Loops Explained](./guides/ralph-loops-explained.md) - Running autonomous development loops\n- [Best Practices](./guides/best-practices.md) - Lessons learned\n\n## Skills\n\n### PRD Skill (`/prd`)\n\nCreates self-verifying PRDs through an interview process:\n1. Identifies what type of task you're doing\n2. Extracts everything you know via brain dump\n3. Asks clarifying questions\n4. Confirms understanding\n5. Generates `PRD.md` and `prd.json`\n\nThe output is a PRD that Ralph TUI can execute autonomously.\n\n### Agent Browser Skill (`/agent-browser`)\n\nHeadless browser automation for AI agents:\n- Navigate, click, fill forms\n- Take screenshots and snapshots\n- E2E testing workflows\n- Web scraping\n\nEssential for any task involving UI verification.\n\n### Setup Claude Skill (`/setup-claude`)\n\nTwo modes:\n\n**Init** - For new repositories (13 phases):\n- Environment & tools check (including tmux)\n- CLI discovery & authentication\n- MCP configuration (context-window aware)\n- Skills, subagents, rules, hooks setup\n- CLAUDE.md generation\n- Ralph TUI configuration\n\n**Audit** - For existing repositories (8 phases):\n- Environment analysis\n- CLI and context window audit\n- Gap analysis\n- Recommendations with interactive fixes\n\n## Repository Structure\n\n```\ncc-guide/\n├── skills/\n│   ├── prd/                  # PRD creation skill\n│   │   ├── SKILL.md          # Entry point\n│   │   ├── AGENTS.md         # Comprehensive reference\n│   │   ├── interview/        # Interview process guides\n│   │   └── categories/       # Task-type specific guidance\n│   │\n│   ├── setup-claude/         # Setup/audit skill\n│   │   ├── SKILL.md          # Entry point\n│   │   ├── workflows/        # Init & audit workflows\n│   │   ├── components/       # Detailed component guides\n│   │   ├── reference/        # Reference material\n│   │   └── templates/        # Config templates\n│   │\n│   └── agent-browser/        # Browser automation skill\n│       └── SKILL.md          # CLI reference\n│\n├── guides/\n│   ├── my-claude-workflow.md\n│   ├── ralph-loops-explained.md\n│   └── best-practices.md\n│\n├── templates/\n│   └── prompt.hbs            # Ralph TUI prompt template\n│\n└── bin/\n    └── add-skill.js          # npx cc-guide add-skill\n```\n\n## Key Concepts\n\n### CLI First, MCP Last\n\nCLIs don't consume context window. MCPs do.\n\nBefore enabling any MCP:\n- Check if a CLI exists (`gh`, `vercel`, `supabase`, `stripe`)\n- Install and authenticate the CLI\n- Only use MCP when there's no CLI alternative\n\n### tmux for Persistence\n\nRalph loops run for hours. tmux means:\n- Sessions persist through SSH disconnects\n- You can detach and come back later\n- Multiple loops can run in parallel\n\n### Worktrees for Parallelism\n\nCan't run two Ralph loops on the same codebase. Git worktrees fix this:\n```bash\ngit worktree add ../project-feature-a feature-a\n```\n\nEach worktree can run its own tmux session with its own Ralph loop.\n\n## License\n\nMIT - See [LICENSE](./LICENSE)\n\n---\n\n**The goal isn't to remove humans from development. It's to elevate humans from typists to architects.**\n","readmeFilename":"README.md"}