{"id":35236254,"url":"https://github.com/albertsikkema/claude-config-template","last_synced_at":"2025-12-30T04:01:48.449Z","repository":{"id":319318982,"uuid":"1076103520","full_name":"albertsikkema/claude-config-template","owner":"albertsikkema","description":"Reusable Claude Code configuration template with custom agents, slash commands, and structured documentation","archived":true,"fork":false,"pushed_at":"2025-11-26T09:22:11.000Z","size":637,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-29T08:45:30.575Z","etag":null,"topics":["agents","ai","automation","claude","claude-code","configuration","development-tools","productivity","template"],"latest_commit_sha":null,"homepage":"https://claude.com/code","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/albertsikkema.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"albertsikkema","thanks_dev":null,"custom":null}},"created_at":"2025-10-14T12:08:44.000Z","updated_at":"2025-11-26T09:22:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"c26ba955-3db9-493b-b1c6-b144449bf095","html_url":"https://github.com/albertsikkema/claude-config-template","commit_stats":null,"previous_names":["albertsikkema/claude-config-template"],"tags_count":5,"template":true,"template_full_name":null,"purl":"pkg:github/albertsikkema/claude-config-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albertsikkema%2Fclaude-config-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albertsikkema%2Fclaude-config-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albertsikkema%2Fclaude-config-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albertsikkema%2Fclaude-config-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/albertsikkema","download_url":"https://codeload.github.com/albertsikkema/claude-config-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/albertsikkema%2Fclaude-config-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28123587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-30T02:00:05.476Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","ai","automation","claude","claude-code","configuration","development-tools","productivity","template"],"created_at":"2025-12-30T04:01:14.080Z","updated_at":"2025-12-30T04:01:48.439Z","avatar_url":"https://github.com/albertsikkema.png","language":"Python","funding_links":["https://buymeacoffee.com/albertsikkema"],"categories":[],"sub_categories":[],"readme":"# Claude Code Configuration Template\n\n\u003e **DEPRECATION NOTICE**\n\u003e \n\u003e This repository is **no longer actively maintained**. I have switched to [OpenCode](https://opencode.ai/) - it's open source, feels faster, offers more model choices, and isn't tied to a single company. The Claude Code subscription limitations, rate limiting, and frequent \"resources not available\" errors also became frustrating.\n\u003e \n\u003e This repository will remain available until **January 1, 2026** for reference purposes. Feel free to fork, copy, or use any code from this repository before then.\n\u003e \n\u003e Updates will be sporadic at best.\n\n---\n\nA powerful, reusable configuration system for [Claude Code](https://claude.com/code) that supercharges your development workflow with custom agents, intelligent slash commands, and structured project documentation.\n\n## ⚡ Quick Install\n\n**First time installation or update (preserves your work):**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash\n```\n\n**Install from a specific branch:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --branch orchestrator-agent\n```\n\n**Clean reinstall (⚠️ overwrites important stuff):**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --force\n```\n\n**Clean reinstall from a specific branch:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --branch orchestrator-agent --force\n```\n\n\u003e **Note**: Always use `/main/install.sh` in the URL. The `--branch` argument specifies which branch's content to actually install.\n\n**Optional: Start monitoring dashboard** (requires [Bun](https://bun.sh)):\n```bash\n./start-monitoring.sh\n```\nSee the [Multi-Agent Observability Dashboard](#-multi-agent-observability-dashboard) section for details.\n\n## 🗑️ Quick Uninstall\n\n**Remove configuration (preserves thoughts/):**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/uninstall.sh | bash\n```\n\n**Remove everything including thoughts/ (⚠️ overwrites important stuff):**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/uninstall.sh | bash -s -- --force\n```\n\n---\n\n## 🎯 What's This?\n\nThis is a **configuration template** that you install into your projects. It provides:\n\n- **Complete development workflow** - Research → Plan → Implement → Cleanup → Deploy ([see WORKFLOW.md](WORKFLOW.md))\n- **12 specialized AI agents** - Automated research, code analysis, and architecture design\n- **14 slash commands** - Streamlined workflows for common tasks (including C4 architecture diagrams and deployment automation)\n- **108 security rules** - Language-specific secure coding guidance from [Project Codeguard](https://github.com/project-codeguard/rules)\n- **Multi-agent observability** - Real-time monitoring dashboard with AI-powered event summaries\n- **Structured documentation system** - Templates and organization for project docs\n- **Pre-configured permissions** - Ready-to-use tool access for development\n\nThink of it as a **productivity multiplier** for Claude Code - install once, benefit forever.\n\n**📖 New to this template? Start with [WORKFLOW.md](WORKFLOW.md) for the complete development workflow guide.**\n\nPartly based on/ inspired by:\n- https://github.com/humanlayer/humanlayer\n- https://github.com/Wirasm/PRPs-agentic-eng\n\nSecurity rules integration:\n- https://github.com/project-codeguard/rules (108 OWASP-aligned security rules)\n\nMonitoring dashboard:\n- https://github.com/disler/claude-code-hooks-multi-agent-observability\n\n\n## 📦 What You Get\n\n### 🤖 Intelligent Agents\n\n**Codebase Intelligence:**\n- `codebase-locator` - Find WHERE code lives\n- `codebase-analyzer` - Understand HOW code works\n- `codebase-pattern-finder` - Discover similar implementations\n- `codebase-researcher` - Orchestrate comprehensive research\n\n**Architecture \u0026 Planning:**\n- `system-architect` - Design systems and evaluate patterns\n- `plan-implementer` - Execute approved technical plans\n\n**Documentation Research:**\n- `project-context-analyzer` - Extract and synthesize project documentation context\n- `best-practices-researcher` - Search documented best practices from previous implementations\n- `technical-docs-researcher` - Search technical documentation for libraries and frameworks\n- `thoughts-analyzer` - Deep dive into your thoughts directory\n- `thoughts-locator` - Find relevant documents\n\n**External Research:**\n- `web-search-researcher` - Research from the web\n\n### ⚡ Slash Commands\n\n| Command | Purpose |\n|---------|---------|\n| `/project` | Create project documentation from templates |\n| `/research_codebase` | Deep codebase investigation |\n| `/create_plan` | Interactive implementation planning |\n| `/implement_plan` | Execute approved plans |\n| `/validate_plan` | Validate implementation correctness |\n| `/cleanup` | Document best practices and clean up ephemeral artifacts |\n| `/build_c4_docs` | Generate C4 architecture diagrams (System Context, Container, Component) |\n| `/commit` | Create well-formatted git commits |\n| `/pr` | Generate comprehensive PR descriptions |\n| `/code_reviewer` | Review code quality |\n| `/security` | Comprehensive security analysis with Codeguard rules |\n| `/deploy` | Automated deployment preparation (version, changelog, build, release) |\n| `/fetch_technical_docs` | Fetch LLM-optimized documentation from context7.com |\n| `/index_codebase` | Index Python/TypeScript/Go codebases |\n\n### 📁 Directory Structure\n\nAfter installation, you'll have:\n\n```\nyour-project/\n├── .claude/\n│   ├── agents/              # 12 specialized agents\n│   ├── commands/            # 14 slash commands\n│   ├── hooks/               # Observability hooks (if monitoring enabled)\n│   └── settings.json        # Configuration and hooks\n│\n├── docs/                    # Helper script documentation\n│   ├── README-fetch-docs.md     # Documentation fetcher guide\n│   ├── README-indexers.md       # Codebase indexers guide\n│   ├── README-c4-diagrams.md    # C4 architecture diagrams guide\n│   ├── README-fetch-openapi.md  # OpenAPI fetcher guide\n│   └── README-spec-metadata.md  # Metadata generator guide\n│\n├── claude-helpers/          # Utility scripts\n│   ├── README.md            # Scripts overview\n│   ├── index_python.py      # Python codebase indexer\n│   ├── index_js_ts.py       # JavaScript/TypeScript codebase indexer\n│   ├── index_go.py          # Go codebase indexer\n│   ├── build_c4_diagrams.py # C4 PlantUML diagram builder\n│   ├── fetch-docs.py        # Documentation fetcher\n│   ├── fetch_openapi.sh     # OpenAPI schema fetcher\n│   └── spec_metadata.sh     # Metadata generator\n│\n└── thoughts/\n    ├── templates/           # Documentation templates\n    │   ├── project.md.template  # Project context template\n    │   ├── todo.md.template     # Active work tracking template\n    │   ├── done.md.template     # Completed work template\n    │   ├── adr.md.template      # Architecture Decision Records template\n    │   └── changelog.md.template # Changelog template\n    │\n    ├── best_practices/      # Best practices documentation from implementations\n    ├── technical_docs/      # Technical documentation storage\n    ├── security_rules/      # Project Codeguard security rules (108 rules)\n    │   ├── core/            # 22 Cisco-curated core security rules\n    │   └── owasp/           # 86 OWASP-based security rules\n    │\n    └── shared/\n        ├── plans/           # Implementation plans (deleted after cleanup)\n        ├── research/        # Research documents (deleted after cleanup)\n        ├── rationalization/ # Ephemeral working docs (deleted after cleanup)\n        └── project/         # Project documentation (3-file structure)\n```\n\n## 🔍 Multi-Agent Observability Dashboard\n\nGain real-time visibility into Claude Code's decision-making process with the monitoring dashboard. Watch agents spawn, tools execute, and see AI-generated summaries of all activities. Basically uses this repo: [https://github.com/disler/claude-code-hooks-multi-agent-observability](https://github.com/disler/claude-code-hooks-multi-agent-observability)\n\n### What You Get\n\n- **Real-time event streaming** - See every tool use, agent spawn, and notification as it happens\n- **AI-powered summaries** - Automatically generated summaries of complex events\n- **Session tracking** - Follow complete conversation flows and agent orchestration\n- **Event filtering** - Focus on specific event types or sessions\n- **WebSocket updates** - Live dashboard updates with no refresh needed\n\n### Quick Start\n\n**Prerequisites**: [Bun](https://bun.sh) must be installed\n```bash\n# Install Bun (macOS/Linux)\ncurl -fsSL https://bun.sh/install | bash\n```\n\n**Option 1: One-Line Setup** (Easiest)\n```bash\n./start-monitoring.sh\n```\n\nThis will:\n1. Clone the monitoring dashboard repository\n2. Install all dependencies using Bun\n3. Set up observability hooks in `.claude/hooks/`\n4. Configure hooks in `.claude/settings.json`\n5. Start the monitoring server and dashboard\n\n**Option 2: Skip Hooks Setup** (if you have custom hooks)\n```bash\n./start-monitoring.sh --skip-hooks\n```\n\n**Option 3: Force Clean Reinstall**\n```bash\n./start-monitoring.sh --force-install\n```\n\n### Accessing the Dashboard\n\nOnce started, access:\n- **Dashboard UI**: http://localhost:5173\n- **Server API**: http://localhost:4000\n\n### What Gets Tracked\n\nThe monitoring system captures:\n- **PreToolUse** - Before any tool executes\n- **PostToolUse** - After tool execution completes\n- **Notification** - User input requests (with optional TTS)\n- **Stop** - Conversation stop events\n- **SubagentStop** - When spawned agents complete\n- **PreCompact** - Before context window compaction\n- **UserPromptSubmit** - User message submissions\n- **SessionStart/End** - Session lifecycle events\n\n### Helper Scripts\n\nAfter starting, you can:\n```bash\n# Stop the monitoring system\n./claude-code-hooks-multi-agent-observability/scripts/reset-system.sh\n\n# Test the monitoring system\n./claude-code-hooks-multi-agent-observability/scripts/test-system.sh\n```\n\n### How It Works\n\n1. **Hooks** in `.claude/hooks/` intercept Claude Code events\n2. **Events** are sent to the server at `http://localhost:4000`\n3. **AI summaries** are generated for complex events (optional)\n4. **Dashboard** displays everything in real-time via WebSocket\n\n### Customization\n\nThe hooks configuration is in `.claude/settings.json`. You can:\n- Disable specific hooks\n- Adjust which events get AI summaries\n- Change the server URL\n- Add custom event processing\n\n## 🚀 Installation Options\n\n### Option 1: Use as GitHub Template \n\n1. Click **\"Use this template\"** on [GitHub](https://github.com/albertsikkema/claude-config-template)\n2. Create your template repository\n3. Clone and use in your projects\n\n### Option 2: Direct Installation\n\n```bash\n# Clone the template\ngit clone https://github.com/albertsikkema/claude-config-template.git\n\n# Navigate to your project\ncd /path/to/your-project\n\n# Install\n/path/to/claude-config-template/install-helper.sh\n```\n\n### Option 3: One-Line Remote Install ⚡ (Recommended)\n\nThe easiest way! Downloads, installs, and cleans up automatically:\n\n```bash\n# Install everything (recommended)\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash\n\n# Install only Claude configuration\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --claude-only\n\n# Install only thoughts structure\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --thoughts-only\n\n# Preview what will be installed (dry run)\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --dry-run\n\n# Install to specific directory\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- /path/to/project\n\n# Combine options\ncurl -fsSL https://raw.githubusercontent.com/albertsikkema/claude-config-template/main/install.sh | bash -s -- --force --claude-only\n```\n\n**How it works**: The remote installer downloads the repository, runs the installation with your options, and automatically cleans up temporary files.\n\n## 🎮 Installation Options\n\n```bash\n# Install everything (default)\n./install-helper.sh\n\n# Install only Claude configuration\n./install-helper.sh --claude-only\n\n# Install only thoughts structure\n./install-helper.sh --thoughts-only\n\n# Preview what will be installed\n./install-helper.sh --dry-run\n\n# Clean reinstall (⚠️ removes all thoughts/ content)\n./install-helper.sh --force\n\n# Install to specific directory\n./install-helper.sh /path/to/project\n```\n\n**Note**:\n- The remote installer (`install.sh`) downloads the repository, installs to your current directory, and cleans up automatically\n- For manual installation from a cloned repository, use `install-helper.sh`\n- The installer automatically updates your project's `.gitignore` to exclude `.claude/`, `thoughts/`, and `claude-helpers/`\n- **Default behavior**: `.claude/` is always updated, `thoughts/` preserves existing content and adds missing directories\n- **With `--force`**: Completely replaces `thoughts/` directory, removing all plans, research, and project docs\n\n## 📚 Helper Scripts \u0026 Documentation\n\nThis template includes several utility scripts in the `claude-helpers/` directory:\n\n- **Codebase Indexers**: Generate searchable markdown documentation\n  - `index_python.py` - Index Python codebases (functions, classes, models)\n  - `index_js_ts.py` - Index JavaScript/TypeScript/React codebases (components, functions, interfaces)\n  - `index_go.py` - Index Go codebases (structs, interfaces, functions)\n  - Use via `/index_codebase` slash command\n  - **📖 See [docs/README-indexers.md](docs/README-indexers.md) for detailed guide**\n\n- **Documentation Fetcher**: Download LLM-optimized documentation\n  - `fetch-docs.py` - Fetch documentation from context7.com\n  - Use via `/fetch_technical_docs` slash command\n  - **📖 See [docs/README-fetch-docs.md](docs/README-fetch-docs.md) for detailed guide**\n\n- **OpenAPI Fetcher**: Extract API schemas from FastAPI\n  - `fetch_openapi.sh` - Fetch OpenAPI/Swagger schemas\n  - Auto-invoked via `/index_codebase` when FastAPI detected\n  - **📖 See [docs/README-fetch-openapi.md](docs/README-fetch-openapi.md) for detailed guide**\n\n- **Metadata Generator**: Capture development context\n  - `spec_metadata.sh` - Generate comprehensive metadata\n  - Used in plans, research, and ADRs\n  - **📖 See [docs/README-spec-metadata.md](docs/README-spec-metadata.md) for detailed guide**\n\n- **Orchestrator Agent**: Automate the full Claude Code workflow\n  - `orchestrator.py` - Runs index → research → plan → implement → review\n  - Supports both OpenAI and Azure OpenAI (auto-detected from `.env.claude`)\n  - Single-file script with `uv run` support\n  ```bash\n  # Create .env.claude with API key\n  echo \"OPENAI_API_KEY=sk-...\" \u003e .env.claude\n\n  # Run full workflow\n  uv run claude-helpers/orchestrator.py \"Add user authentication\"\n\n  # Stop after planning (no implementation)\n  uv run claude-helpers/orchestrator.py --no-implement \"Refactor database\"\n  ```\n  **Tip**: Add an alias for easy access:\n  ```bash\n  # Add to ~/.zshrc or ~/.bashrc\n  alias orchestrate='uv run /path/to/claude-helpers/orchestrator.py'\n  ```\n\n**📖 Full scripts overview: [claude-helpers/README.md](claude-helpers/README.md)**\n\n## 📚 Complete Development Workflow\n\nThis template provides a systematic **Research → Plan → Implement → Cleanup** workflow based on \"Faking a Rational Design Process in the AI Era\".\n\n**📖 See [WORKFLOW.md](WORKFLOW.md) for the complete guide** covering:\n\n- **Phase 0**: Index Codebase (optional but recommended)\n- **Phase 1**: Project Setup (one-time)\n- **Phase 2**: Research\n- **Phase 3**: Plan\n- **Phase 4**: Implement\n- **Phase 5**: Validate\n- **Phase 6**: Cleanup (MANDATORY - documents best practices, removes ephemeral artifacts)\n- **Phase 7**: Commit \u0026 PR\n\n### Quick Start Example\n\n```bash\n# 1. Index your codebase (optional but makes research faster)\nYou: /index_codebase\n\n# 2. Document your project (one-time setup)\nYou: /project Create full docs for my e-commerce platform\n\n# 3. Research before building\nYou: /research_codebase payment processing flow\n\n# 4. Create implementation plan\nYou: /create_plan add Stripe payment integration\n\n# 5. Implement the plan\nYou: /implement_plan thoughts/shared/plans/2025-10-14-stripe-integration.md\n\n# 6. Validate implementation\nYou: /validate_plan thoughts/shared/plans/2025-10-14-stripe-integration.md\n\n# 7. Cleanup (MANDATORY - documents best practices, removes artifacts)\nYou: /cleanup thoughts/shared/plans/2025-10-14-stripe-integration.md\n\n# 8. Commit and create PR\nYou: /commit\nYou: /pr\n```\n\n**👉 Read [WORKFLOW.md](WORKFLOW.md) for detailed explanations, examples, and best practices.**\n\n## 📝 File Naming Conventions\n\n**Plans \u0026 Research**: `YYYY-MM-DD-description.md` or `YYYY-MM-DD-TICKET-123-description.md`\n```\n2025-10-14-oauth-support.md\n2025-10-14-ENG-1478-user-tracking.md\n```\n\n**Project Documentation**: Ultra-lean 3-file structure\n```\nthoughts/shared/project/project.md    # Project context (what/why/stack)\nthoughts/shared/project/todo.md       # Active work (Must Haves/Should Haves)\nthoughts/shared/project/done.md       # Completed work history\n```\n\n**Best Practices**: Category-based naming as `[category]-[topic].md`\n```\nthoughts/best_practices/authentication-oauth-patterns.md\nthoughts/best_practices/database-transaction-handling.md\nthoughts/best_practices/api-error-handling.md\n```\n\n## 🎨 Customization\n\n### Add Your Own Agent\n\nCreate `.claude/agents/my-agent.md`:\n\n```markdown\n---\nname: my-custom-agent\ndescription: What this agent does\nmodel: sonnet\ncolor: blue\n---\n\nYour agent instructions here...\n```\n\n### Add Custom Command\n\nCreate `.claude/commands/my-command.md`:\n\n```markdown\n# My Custom Command\n\nYour command instructions here...\n```\n\n### Adjust Permissions\n\nEdit `.claude/settings.json`:\n\n```json\n{\n  \"permissions\": {\n    \"allow\": [\n      \"Bash(command:*)\",\n      \"WebFetch(domain:example.com)\"\n    ],\n    \"deny\": []\n  }\n}\n```\n\n## 🗑️ Uninstallation\n\n```bash\n# Remove configuration (preserves thoughts/)\n./uninstall.sh\n\n# Remove only Claude config\n./uninstall.sh --claude-only\n\n# Preview what will be removed\n./uninstall.sh --dry-run\n\n# Remove everything including thoughts/ (⚠️ deletes your work)\n./uninstall.sh --force\n```\n\n**Default behavior**: Removes `.claude/` and `claude-helpers/` but **preserves** `thoughts/` directory with your plans, research, and project docs.\n\n**With `--force`**: Removes **everything** including all your work in `thoughts/`.\n\n\n## 🌟 Key Features Explained\n\n### Project Codeguard Security Integration\n\nThe `/security` command integrates **108 comprehensive security rules** from [Project Codeguard](https://github.com/project-codeguard/rules):\n\n- **22 core rules** - Authentication, input validation, authorization, cryptography, etc.\n- **86 OWASP rules** - SQL injection, XSS, CSRF, session management, etc.\n- **Language-specific guidance** - Python, JavaScript, Go, Java, C, and more\n- **Code examples** - Safe implementations and secure coding patterns\n- **Automatic loading** - Rules filtered by your project's detected technology stack\n\nWhen you run `/security`, it automatically:\n1. Detects your languages and frameworks\n2. Loads relevant Codeguard rules from `thoughts/security_rules/`\n3. Analyzes your code against 18 security areas + Codeguard patterns\n4. Generates reports with rule references and recommendations\n\n**Source**: Curated by Cisco and aligned with OWASP best practices.\n\n### Research → Plan → Implement → Cleanup Pattern\n\nThe core workflow ensures quality and preserves knowledge:\n\n1. **Research**: Understand before building (spawns parallel agents, documents findings)\n2. **Plan**: Design before coding (interactive planning with user)\n3. **Implement**: Execute with clarity (step-by-step with validation)\n4. **Cleanup**: Document best practices and remove ephemeral artifacts (see [WORKFLOW.md](WORKFLOW.md))\n\n### Intelligent Agents\n\nAgents work autonomously and can be:\n- **Invoked automatically** by Claude Code when needed\n- **Requested explicitly** by you\n- **Run in parallel** for faster results\n\n### Structured Documentation\n\nUltra-lean 3-file structure + best practices:\n- **project.md** - Project context (what/why/stack/constraints)\n- **todo.md** - Active work with MoSCoW prioritization (Must Haves/Should Haves)\n- **done.md** - Completed work history with full traceability\n- **best_practices/** - Documented patterns, decisions, and lessons learned from implementations\n\nSee the \"Ultra-Lean 3-File Documentation Method\" section in [WORKFLOW.md](WORKFLOW.md) for methodology details.\n\n## 📖 Real-World Examples\n\n### Example 1: New Feature Development\n\n```\nYou: /research_codebase I need to add two-factor authentication\n\nClaude uses agents to:\n1. Research existing auth code (codebase-analyzer)\n2. Find similar implementations (codebase-pattern-finder)\n3. Check best practices (best-practices-researcher)\n4. Check technical docs (technical-docs-researcher)\n\nThen read and use the created research file to create a plan, implement etc.\n```\n\n### Example 2: Understanding Legacy Code\n\n```\nYou: /research_codebase How does the caching layer work?\n\nClaude spawns parallel agents to:\n- Locate cache-related files\n- Analyze implementation details\n- Document the architecture\n\nResult: Comprehensive research document with file:line references\n```\n\n### Example 3: Project Setup\n\n```\nYou: /project Create complete project documentation\n\nClaude asks about:\n- Tech stack\n- Team size\n- Development phase\n- Core features\n\nResult: Full project documentation customized for your needs\n```\n\n## 🤝 Contributing\n\nContributions are welcome from individuals and companies alike! We'd love to see:\n\n- New agents and slash commands\n- Improved documentation and examples\n- Bug fixes and enhancements\n- Installation script improvements\n- Templates and workflow ideas\n\n**See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:**\n- How to submit contributions\n- Agent and command development best practices\n- Testing requirements\n- Pull request process\n\nFor questions or larger contributions, contact: license@albertsikkema.com\n\n## 💡 Tips \u0026 Best Practices\n\n1. **Follow the workflow** - See [WORKFLOW.md](WORKFLOW.md) for the complete process\n2. **Index first** - Run `/index_codebase` before research for faster results\n3. **Research before planning** - Always understand before building\n4. **Never skip cleanup** - It documents best practices and removes clutter for future AI sessions\n5. **Document best practices** - Capture lessons learned, not just decisions\n6. **Review permissions** - Audit `settings.local.json` regularly\n\n## 📊 Version\n\nCurrent version: **1.4.0**\n\n## 🆘 Support \u0026 Troubleshooting\n\n### Common Issues\n\n**\"Unknown slash command: project\"**\n\nIf the `/project` command isn't recognized after installation:\n\n1. **Restart Claude Code** - Close and reopen the application\n2. **Check installation** - Verify `.claude/commands/project.md` exists\n3. **Reload configuration** - Use the `/clear` command in Claude Code\n4. **Re-install** - Run `./install-helper.sh --force` to ensure files are correct\n\n**Agent not found**\n\nIf agents aren't being recognized:\n- Verify `.claude/agents/` contains all 11 agent files\n- Restart Claude Code\n- Check file permissions (files should be readable)\n\n**Git tracking configuration files**\n\nThe installer automatically adds `.claude/`, `thoughts/`, and `claude-helpers/` to your `.gitignore`. If you want to track these:\n- Edit `.gitignore` and remove the entries you want to track\n- Or use `git add -f` to force-add specific files\n\n### Getting Help\n\n- **Issues**: [GitHub Issues](https://github.com/albertsikkema/claude-config-template/issues)\n- **Documentation**: [Claude Code Docs](https://docs.claude.com)\n- **Template Updates**: Re-run the installer to update `.claude/` and add any new `thoughts/` directories\n\n## 📄 License\n\nMIT License - See LICENSE file for details\n\n## 🎯 What Makes This Special?\n\nUnlike basic Claude Code configurations, this template provides:\n\n✅ **Complete workflow system** - Not just tools, but processes\n✅ **Intelligent automation** - Agents that think and research\n✅ **Structured knowledge** - Organized documentation system\n✅ **Battle-tested patterns** - Proven workflows that work\n✅ **Easy to customize** - Extend and adapt to your needs\n\n## 🚦 Getting Started Checklist\n\nAfter installation:\n\n- [ ] **Restart Claude Code** to load new configuration\n- [ ] Verify installation: Check `.claude/` and `thoughts/` directories exist\n- [ ] Review `.claude/settings.json` permissions\n- [ ] **(Optional)** Start monitoring dashboard: `./start-monitoring.sh`\n- [ ] **Read [WORKFLOW.md](WORKFLOW.md)** to understand the complete process\n- [ ] Run `/index_codebase` to create searchable indexes (optional but recommended)\n- [ ] Run `/project` to document your project (if command not found, see troubleshooting)\n- [ ] Follow the workflow: Research → Plan → Implement → Validate → Cleanup → PR\n- [ ] Add project-specific agents if needed\n- [ ] Share with your team!\n\n---\n\n**Ready to supercharge your development workflow?**\n\nInstall now and experience the future of AI-assisted development! 🚀\n\nMade with ❤️ for the Claude Code community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbertsikkema%2Fclaude-config-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falbertsikkema%2Fclaude-config-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbertsikkema%2Fclaude-config-template/lists"}