create-claude-context 1.0.0

package/templates/base/commands/rpi-research.md

@@ -0,0 +1,88 @@
+---
+name: rpi-research
+version: "1.0.0"
+description: "RPI Research Phase: Systematic codebase exploration for feature/fix analysis"
+category: "rpi-orchestration"
+rpi_phase: "research"
+context_budget_estimate: "50K tokens"
+typical_context_usage: "25%"
+prerequisites: []
+outputs:
+  - "Research document in .claude/research/active/[name]_research.md"
+  - "File inventory with line references"
+  - "Call chain diagrams"
+  - "Dependency map"
+next_commands: ["/rpi-plan"]
+related_agents: ["context-engineer", "core-architect"]
+examples:
+  - command: "/rpi-research user-authentication"
+    description: "Research authentication flow for new feature"
+  - command: "/rpi-research payment-bug-fix"
+    description: "Investigate payment processing issue"
+exit_criteria:
+  - "Research document created in .claude/research/active/"
+  - "All relevant files identified (3-20 files)"
+  - "Call chains traced with line numbers"
+  - "Dependencies mapped"
+  - "150-word summary generated"
+---
+
+# RPI Research Phase
+
+**Purpose:** Systematic, zero-code-modification exploration
+
+**Syntax:** `/rpi-research [feature-name]`
+
+**Example:**
+```bash
+/rpi-research user-authentication
+/rpi-research payment-bug-fix
+```
+
+---
+
+## Execution Steps
+
+### Step 1: Initialize Research Document
+Create `.claude/research/active/[feature]_research.md` from RESEARCH_TEMPLATE.md
+
+### Step 2: Entry Point Discovery (3 parallel agents)
+- Agent 1: API/Route entry points
+- Agent 2: Business logic locations
+- Agent 3: Database/external integrations
+
+### Step 3: Call Chain Tracing
+- Read entry point files
+- Trace 3 levels deep
+- Record with file:line references
+
+### Step 4: Dependency Mapping
+- Internal service dependencies
+- External API dependencies
+
+### Step 5: Test Coverage Analysis
+- Find existing tests
+- Identify gaps
+
+### Step 6: Generate Summary
+- 150-word summary for Plan phase
+
+---
+
+## Output
+
+Research document in `.claude/research/active/[feature]_research.md`
+
+---
+
+## Context Budget
+
+- Target: 25% of 200k (50k tokens)
+- Compaction: After each major step
+- Final: ~20k tokens (research doc only)
+
+---
+
+## Next Step
+
+After completion: `/rpi-plan [feature-name]`

package/templates/base/commands/validate-all.md

@@ -0,0 +1,77 @@
+---
+name: validate-all
+version: "1.0.0"
+description: "Complete validation suite for the codebase"
+category: "validation"
+context_budget_estimate: "40K tokens"
+typical_context_usage: "20%"
+prerequisites: []
+outputs:
+  - "Validation report with PASS/FAIL per category"
+  - "Documentation accuracy metrics"
+  - "Test results summary"
+  - "Overall READY/NOT READY status"
+next_commands: []
+related_agents: ["context-engineer", "deployment-ops"]
+examples:
+  - command: "/validate-all"
+    description: "Run complete validation before deployment"
+exit_criteria:
+  - "Documentation validation complete"
+  - "Test validation complete"
+  - "Code quality checks complete"
+  - "Configuration validation complete"
+  - "Overall status determined"
+---
+
+# Complete Validation Suite
+
+**Purpose:** Run all validation checks before deployment
+
+**Syntax:** `/validate-all`
+
+---
+
+## Validation Checks
+
+### 1. Documentation Validation
+- All workflows have valid line numbers
+- All markdown links resolve
+- CODE_TO_WORKFLOW_MAP is current
+
+### 2. Test Validation
+- All unit tests pass
+- All integration tests pass
+- Coverage meets threshold
+
+### 3. Code Quality
+- No linting errors
+- Type checking passes (if applicable)
+- No security vulnerabilities
+
+### 4. Configuration Validation
+- All required environment variables defined
+- Configuration files valid
+
+---
+
+## Output Format
+
+```
+VALIDATION REPORT
+
+Documentation:  ✅ PASS / ❌ FAIL
+Tests:          ✅ PASS / ❌ FAIL
+Code Quality:   ✅ PASS / ❌ FAIL
+Configuration:  ✅ PASS / ❌ FAIL
+
+Overall: READY / NOT READY
+```
+
+---
+
+## When to Run
+
+- Before creating PR
+- Before deploying
+- After major refactoring

package/templates/base/commands/verify-docs-current.md

@@ -0,0 +1,86 @@
+---
+name: verify-docs-current
+version: "1.0.0"
+description: "Verify documentation accuracy against current code"
+category: "validation"
+context_budget_estimate: "20K tokens"
+typical_context_usage: "10%"
+prerequisites: []
+outputs:
+  - "Verification report with accuracy status"
+  - "List of outdated line references"
+  - "Link validation results"
+next_commands: []
+related_agents: ["context-engineer"]
+examples:
+  - command: "/verify-docs-current src/services/payment.py"
+    description: "Check documentation for payment service"
+  - command: "/verify-docs-current src/api/routes.py"
+    description: "Verify API routes documentation"
+exit_criteria:
+  - "All affected workflows checked"
+  - "Line number accuracy calculated"
+  - "Links validated"
+  - "Status reported (HEALTHY/NEEDS UPDATE/STALE)"
+---
+
+# Verify Documentation Currency
+
+**Purpose:** Validate that documentation matches current code
+
+**Syntax:** `/verify-docs-current [file_path]`
+
+**Example:**
+```bash
+/verify-docs-current src/services/payment.py
+```
+
+---
+
+## What This Command Does
+
+1. Look up modified file in CODE_TO_WORKFLOW_MAP.md
+2. Find all workflows that document this file
+3. For each workflow:
+   - Extract [Line XXX] references
+   - Read actual code at those lines
+   - Verify function/logic still exists (±10 lines tolerance)
+4. Check all markdown links resolve
+5. Generate accuracy report
+
+---
+
+## Output Format
+
+```
+VERIFICATION REPORT
+
+File: [path/to/file]
+Affected Workflows: X
+
+[workflow_1.md]:
+  ✅ Line XXX (function_name) - Accurate
+  ⚠️ Line YYY (other_func) - Shifted to line ZZZ
+  ❌ Line AAA (deleted_func) - NOT FOUND
+
+Links: X/Y valid (Z%)
+Overall: HEALTHY / NEEDS UPDATE / STALE
+```
+
+---
+
+## Actions Based on Result
+
+| Status | Action Required |
+|--------|-----------------|
+| HEALTHY | No action needed |
+| NEEDS UPDATE | Update line numbers |
+| STALE | Re-document workflow section |
+
+---
+
+## When to Run
+
+- After ANY code modification
+- Before deploying
+- Monthly as maintenance check

package/templates/base/config/base.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "../schemas/settings.schema.json",
+  "version": "1.1.0",
+  "context_engineering": {
+    "enabled": true,
+    "max_context_tokens": 200000,
+    "max_output_tokens": 30000,
+    "target_utilization": 0.40,
+    "compact_trigger": 0.35
+  },
+  "rpi_workflow": {
+    "enabled": true,
+    "phases": ["research", "plan", "implement"],
+    "require_human_approval": true,
+    "auto_doc_update": true,
+    "research_timeout_minutes": 30,
+    "plan_timeout_minutes": 20
+  },
+  "documentation": {
+    "self_maintaining": true,
+    "verify_after_changes": true,
+    "line_number_tolerance": 10,
+    "auto_commit_docs": false
+  },
+  "agents": {
+    "default": "context-engineer",
+    "auto_select": true,
+    "fallback": "core-architect"
+  },
+  "commands": {
+    "rpi_commands": ["/rpi-research", "/rpi-plan", "/rpi-implement"],
+    "validation_commands": ["/verify-docs-current", "/validate-all"]
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 60,
+    "link_check_external": false
+  },
+  "logging": {
+    "level": "info",
+    "file": ".claude/logs/claude.log",
+    "max_size_mb": 10
+  },
+  "telemetry": {
+    "enabled": false,
+    "events": {
+      "command_usage": true,
+      "agent_usage": true,
+      "context_metrics": true,
+      "error_reports": true
+    },
+    "privacy": {
+      "anonymize_paths": true,
+      "exclude_content": true
+    }
+  }
+}

package/templates/base/config/environments/development.json

@@ -0,0 +1,13 @@
+{
+  "$comment": "Development environment overrides",
+  "logging": {
+    "level": "debug"
+  },
+  "validation": {
+    "on_commit": false,
+    "line_accuracy_threshold": 50
+  },
+  "rpi_workflow": {
+    "require_human_approval": false
+  }
+}

package/templates/base/config/environments/production.json

@@ -0,0 +1,17 @@
+{
+  "$comment": "Production environment overrides",
+  "logging": {
+    "level": "warn"
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 70,
+    "link_check_external": true
+  },
+  "rpi_workflow": {
+    "require_human_approval": true
+  },
+  "documentation": {
+    "auto_commit_docs": false
+  }
+}

package/templates/base/config/environments/staging.json

@@ -0,0 +1,13 @@
+{
+  "$comment": "Staging environment overrides",
+  "logging": {
+    "level": "info"
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 60
+  },
+  "rpi_workflow": {
+    "require_human_approval": true
+  }
+}

package/templates/base/config/local.json.example

@@ -0,0 +1,21 @@
+{
+  "$comment": "Local overrides - copy to local.json (gitignored)",
+  "$instructions": "This file is an example. Copy to local.json and customize.",
+
+  "logging": {
+    "level": "debug",
+    "file": ".claude/logs/claude-local.log"
+  },
+
+  "validation": {
+    "on_commit": false
+  },
+
+  "rpi_workflow": {
+    "require_human_approval": false
+  },
+
+  "telemetry": {
+    "enabled": false
+  }
+}

package/templates/base/context/ARCHITECTURE_SNAPSHOT.md

@@ -0,0 +1,156 @@
+# Architecture Snapshot - {{PROJECT_NAME}}
+
+**Purpose:** High-level system map for rapid orientation
+**Load:** When starting a new session or onboarding
+**Size:** ~10k tokens (5% of 200k budget)
+**Last Updated:** {{DATE}}
+
+---
+
+## System Overview
+
+{{SYSTEM_OVERVIEW_DIAGRAM}}
+
+---
+
+## Technology Stack
+
+| Layer | Technology | Purpose |
+|-------|------------|---------|
+| **Frontend** | {{FRONTEND_TECH}} | {{FRONTEND_PURPOSE}} |
+| **Backend** | {{BACKEND_TECH}} | {{BACKEND_PURPOSE}} |
+| **Database** | {{DATABASE_TECH}} | {{DATABASE_PURPOSE}} |
+| **Cache** | {{CACHE_TECH}} | {{CACHE_PURPOSE}} |
+| **Queue** | {{QUEUE_TECH}} | {{QUEUE_PURPOSE}} |
+
+---
+
+## Core Components
+
+### Component 1: {{COMPONENT_1_NAME}}
+
+**Purpose:** {{COMPONENT_1_PURPOSE}}
+**Key Files:**
+- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
+- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
+
+**Related Workflows:**
+- [workflow_1.md](./workflows/workflow_1.md)
+
+---
+
+### Component 2: {{COMPONENT_2_NAME}}
+
+[Same structure...]
+
+---
+
+## Data Flow
+
+```
+{{DATA_FLOW_DIAGRAM}}
+```
+
+---
+
+## Database Schema Summary
+
+**Total Tables:** {{TABLE_COUNT}}
+
+| Table | Purpose | Key Relationships |
+|-------|---------|-------------------|
+| `{{TABLE_1}}` | {{TABLE_1_PURPOSE}} | FK to {{RELATED_TABLE}} |
+| `{{TABLE_2}}` | {{TABLE_2_PURPOSE}} | FK to {{RELATED_TABLE}} |
+
+**Schema Details:** {{MODELS_FILE}}
+
+---
+
+## External Integrations
+
+| Integration | Type | Purpose | Docs |
+|-------------|------|---------|------|
+| {{INTEGRATION_1}} | API | {{PURPOSE_1}} | {{DOCS_LINK}} |
+| {{INTEGRATION_2}} | API | {{PURPOSE_2}} | {{DOCS_LINK}} |
+
+---
+
+## Key Architectural Decisions
+
+### Decision 1: {{DECISION_1_TITLE}}
+
+**Choice:** {{WHAT_WAS_CHOSEN}}
+**Why:** {{RATIONALE}}
+**Trade-offs:** {{TRADE_OFFS}}
+
+---
+
+### Decision 2: {{DECISION_2_TITLE}}
+
+[Same structure...]
+
+---
+
+## Directory Structure
+
+```
+{{PROJECT_ROOT}}/
+├── {{DIR_1}}/              # {{DIR_1_PURPOSE}}
+│   ├── {{SUBDIR_1}}/       # {{SUBDIR_1_PURPOSE}}
+│   └── {{SUBDIR_2}}/       # {{SUBDIR_2_PURPOSE}}
+├── {{DIR_2}}/              # {{DIR_2_PURPOSE}}
+├── {{DIR_3}}/              # {{DIR_3_PURPOSE}}
+└── {{DIR_4}}/              # {{DIR_4_PURPOSE}}
+```
+
+---
+
+## Security Model
+
+### Authentication
+{{AUTHENTICATION_DESCRIPTION}}
+
+### Authorization
+{{AUTHORIZATION_DESCRIPTION}}
+
+### Data Protection
+{{DATA_PROTECTION_DESCRIPTION}}
+
+---
+
+## Performance Characteristics
+
+| Metric | Target | Current |
+|--------|--------|---------|
+| API Response Time | {{TARGET_1}} | {{CURRENT_1}} |
+| Throughput | {{TARGET_2}} | {{CURRENT_2}} |
+| Availability | {{TARGET_3}} | {{CURRENT_3}} |
+
+---
+
+## Deployment Architecture
+
+```
+{{DEPLOYMENT_DIAGRAM}}
+```
+
+**Environments:**
+| Environment | URL | Purpose |
+|-------------|-----|---------|
+| Development | {{DEV_URL}} | Local development |
+| Staging | {{STAGING_URL}} | Pre-production testing |
+| Production | {{PROD_URL}} | Live system |
+
+---
+
+## See Also
+
+- **Detailed workflows:** [WORKFLOW_INDEX.md](./WORKFLOW_INDEX.md)
+- **File responsibilities:** [FILE_OWNERSHIP.md](./FILE_OWNERSHIP.md)
+- **External APIs:** [INTEGRATION_POINTS.md](./INTEGRATION_POINTS.md)
+- **Lessons learned:** [KNOWN_GOTCHAS.md](./KNOWN_GOTCHAS.md)
+
+---
+
+**Version:** 1.0
+**Verified Against Commit:** {{COMMIT_HASH}}

package/templates/base/context/CODE_TO_WORKFLOW_MAP.md

@@ -0,0 +1,94 @@
+# Code to Workflow Map
+
+**Purpose:** Reverse index - Given a code file, find which workflows document it
+**Use:** After modifying any file, look up what documentation needs updating
+**Last Updated:** {{DATE}}
+
+---
+
+## How to Use This File
+
+1. **Modified a file?** Search for it below
+2. **Find "Documented In" section** for affected workflows
+3. **Check "Update After Changing" section** for required updates
+4. **Run `/verify-docs-current [file]`** to validate
+
+---
+
+## File → Workflow Mapping
+
+### {{DIRECTORY_1}}/
+
+#### `{{FILE_1}}` [XXX lines]
+
+**Documented In:**
+- [workflows/workflow_1.md](./workflows/workflow_1.md) - Section 2
+- [workflows/workflow_2.md](./workflows/workflow_2.md) - Section 4
+
+**Update After Changing:**
+- Workflow: workflow_1.md (if [specific thing] changes)
+- Agent: agent_name.md (if [capability] changes)
+- CLAUDE.md (if [architecture] changes)
+
+---
+
+#### `{{FILE_2}}` [XXX lines]
+
+**Documented In:**
+- [workflows/workflow_3.md](./workflows/workflow_3.md) - Complete file
+
+**Update After Changing:**
+- Workflow: workflow_3.md (always)
+
+---
+
+### {{DIRECTORY_2}}/
+
+[Same structure for each directory...]
+
+---
+
+## Files NOT Currently Documented
+
+These files exist but are not yet in any workflow:
+
+| File | Reason | Priority |
+|------|--------|----------|
+| `path/file.ext` | [Why not documented] | LOW/MED/HIGH |
+
+---
+
+## Documentation Update Checklist
+
+After ANY code change:
+
+1. [ ] Find modified file in this map
+2. [ ] Check all "Documented In" workflows
+3. [ ] Update line numbers if code moved
+4. [ ] Update function signatures if changed
+5. [ ] Update business logic descriptions if changed
+6. [ ] Run `/verify-docs-current [file]`
+7. [ ] Commit documentation updates with code
+
+---
+
+## Automation
+
+### Quick Lookup Command
+
+```bash
+# Find what documents a specific file
+grep -l "path/to/file" .claude/context/workflows/*.md
+```
+
+### Validation Command
+
+```bash
+/verify-docs-current path/to/modified/file.ext
+```
+
+---
+
+**Version:** 1.0
+**Files Tracked:** {{FILES_COUNT}}
+**Workflows Linked:** {{WORKFLOWS_COUNT}}