create-universal-ai-context 2.0.0

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

@@ -0,0 +1,115 @@
+---
+name: rpi-implement
+version: "1.0.0"
+description: "RPI Implement Phase: Execute plan with atomic changes and continuous testing"
+category: "rpi-orchestration"
+rpi_phase: "implement"
+context_budget_estimate: "60K tokens"
+typical_context_usage: "30%"
+prerequisites:
+  - "Plan document exists in .ai-context/plans/active/"
+  - "Plan has been approved by human"
+  - "Git branch is clean"
+  - "All tests currently passing"
+outputs:
+  - "Implemented feature/fix"
+  - "Updated documentation with new line numbers"
+  - "Commits with descriptive messages"
+  - "Archived plan in .ai-context/plans/completed/"
+next_commands: ["/verify-docs-current", "/validate-all"]
+related_agents: ["core-architect", "database-ops", "api-developer", "deployment-ops"]
+examples:
+  - command: "/rpi-implement user-authentication"
+    description: "Execute the approved authentication plan"
+  - command: "/rpi-implement payment-bug-fix"
+    description: "Implement the approved bug fix"
+exit_criteria:
+  - "All plan steps completed"
+  - "All tests passing"
+  - "Documentation updated"
+  - "Changes committed"
+  - "Plan archived to completed/"
+---
+
+# RPI Implement Phase
+
+**Purpose:** Execute implementation plan atomically
+
+**Syntax:** `/rpi-implement [feature-name]`
+
+**Prerequisites:** Plan must be approved in `.ai-context/plans/active/`
+
+---
+
+## Golden Rule
+
+```
+ONE CHANGE → ONE TEST → ONE COMMIT
+```
+
+---
+
+## Execution Steps
+
+### Step 1: Load Plan
+Read `.ai-context/plans/active/[feature]_plan.md`
+
+### Step 2: Verify Preconditions
+- [ ] Plan is approved
+- [ ] Branch is clean
+- [ ] Tests pass before changes
+
+### Step 3: Execute Each Step
+For each step in plan:
+1. Make the single, atomic change
+2. Run step-specific test
+3. If pass: commit with descriptive message
+4. If fail: stop, investigate, do not proceed
+
+### Step 4: Context Reset (Every 3 Steps)
+1. Update progress in plan
+2. Re-read plan document
+3. Verify scope alignment
+4. Compact if >35% context usage
+
+### Step 5: Run Full Test Suite
+After all steps complete
+
+### Step 6: Update Documentation (MANDATORY)
+1. Check CODE_TO_WORKFLOW_MAP.md
+2. Update affected workflow files
+3. Update line numbers
+4. Run /verify-docs-current
+
+### Step 7: Final Commit
+Documentation updates
+
+### Step 8: Archive Plan
+Move to `.ai-context/plans/completed/`
+
+---
+
+## Error Recovery
+
+| Error Type | Action |
+|------------|--------|
+| Syntax Error | Fix immediately |
+| Test Failure | Stop, investigate |
+| 3+ Failures | Compact, start new session |
+
+---
+
+## Context Budget
+
+- Plan: 15k tokens
+- Active code: 30k tokens
+- Test results: 15k tokens
+- Total: 60k tokens (30%)
+
+---
+
+## Output
+
+- Completed feature/fix
+- Updated documentation
+- Plan archived to completed/

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

@@ -0,0 +1,93 @@
+---
+name: rpi-plan
+version: "1.0.0"
+description: "RPI Plan Phase: Create implementation blueprint with file:line precision"
+category: "rpi-orchestration"
+rpi_phase: "plan"
+context_budget_estimate: "35K tokens"
+typical_context_usage: "17%"
+prerequisites:
+  - "Research document exists in .ai-context/research/active/"
+  - "/rpi-research phase completed"
+outputs:
+  - "Plan document in .ai-context/plans/active/[name]_plan.md"
+  - "Modification table with file:line references"
+  - "Step-by-step implementation guide"
+  - "Test strategy"
+  - "Rollback plan"
+next_commands: ["/rpi-implement"]
+related_agents: ["core-architect", "database-ops", "api-developer"]
+examples:
+  - command: "/rpi-plan user-authentication"
+    description: "Create implementation plan for auth feature"
+  - command: "/rpi-plan payment-bug-fix"
+    description: "Plan the fix for payment issue"
+exit_criteria:
+  - "Plan document created in .ai-context/plans/active/"
+  - "All file modifications listed with line numbers"
+  - "Step-by-step implementation defined"
+  - "Test strategy documented"
+  - "Human approval obtained"
+---
+
+# RPI Plan Phase
+
+**Purpose:** Create detailed implementation blueprint
+
+**Syntax:** `/rpi-plan [feature-name]`
+
+**Prerequisites:** Research document must exist in `.ai-context/research/active/`
+
+---
+
+## Execution Steps
+
+### Step 1: Load Research Document
+Read `.ai-context/research/active/[feature]_research.md`
+
+### Step 2: Define Scope
+- In scope (explicit list)
+- Out of scope (what we're NOT touching)
+
+### Step 3: List File Modifications
+| File | Lines | Change | Risk |
+|------|-------|--------|------|
+Each modification with exact line numbers
+
+### Step 4: Create Step-by-Step Plan
+For each step:
+- Current code
+- Proposed change
+- Test to run after
+
+### Step 5: Define Test Strategy
+- Unit tests required
+- Integration tests required
+- E2E tests if applicable
+
+### Step 6: Document Rollback Plan
+- How to revert
+- Safe commit to return to
+
+### Step 7: Request Human Approval
+Plan requires human review before implementation
+
+---
+
+## Output
+
+Plan document in `.ai-context/plans/active/[feature]_plan.md`
+
+---
+
+## Context Budget
+
+- Research doc: 20k tokens
+- Plan creation: 15k tokens
+- Total: 35k tokens (17%)
+
+---
+
+## Next Step
+
+After human approval: `/rpi-implement [feature-name]`

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 .ai-context/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 .ai-context/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 `.ai-context/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 `.ai-context/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/session-resume.md

@@ -0,0 +1,144 @@
+---
+name: session-resume
+description: Resume a previous session with full context restoration
+version: 1.0.0
+category: session
+context_budget: 10000
+inputs:
+  - session/current/state.json
+  - session/history/**/*.json
+outputs:
+  - Restored session context
+---
+
+# /session-resume
+
+Resume a previous session, restoring task context, loaded files reference, and pending updates.
+
+## Syntax
+
+```
+/session-resume [sessionId | --list | --last]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `sessionId` | Resume specific session by ID |
+| `--list` | Show available sessions |
+| `--last` | Resume most recent session (default) |
+| `--checkpoint <id>` | Resume from specific checkpoint |
+
+## Examples
+
+### Resume Last Session
+```
+/session-resume
+```
+or
+```
+/session-resume --last
+```
+
+### List Available Sessions
+```
+/session-resume --list
+```
+Shows recent sessions with IDs, dates, and task names.
+
+### Resume Specific Session
+```
+/session-resume abc123-def456
+```
+
+### Resume from Checkpoint
+```
+/session-resume --checkpoint chk-789xyz
+```
+
+## What Gets Restored
+
+| Data | Action |
+|------|--------|
+| Phase | Set to previous RPI phase |
+| Task | Display task name and description |
+| Files | List files that were loaded (for re-loading) |
+| Pending Updates | Show queued doc updates |
+| Context | Suggest files to reload |
+
+## Resume Flow
+
+1. **Load Session State**
+   - Read from history or current state
+   - Validate session data
+
+2. **Display Summary**
+   ```
+   RESUMING SESSION
+
+   Session: abc123-def456
+   Started: 2025-01-24 10:30:00
+   Phase: implement (Step 3 of 5)
+   Task: Add user authentication
+
+   Files Previously Loaded:
+   - src/auth/login.py
+   - src/models/user.py
+   - tests/test_auth.py
+
+   Pending Documentation Updates: 3
+   - workflows/authentication.md (line numbers shifted)
+   - workflows/user-management.md (new function added)
+
+   Artifacts:
+   - research/active/user-auth_research.md
+   - plans/active/user-auth_plan.md
+   ```
+
+3. **Offer Actions**
+   - [Continue] - Proceed with task
+   - [Load Files] - Reload previously loaded files
+   - [Process Updates] - Run /auto-sync for pending updates
+   - [Start Fresh] - Archive and start new session
+
+## Session List Format
+
+```
+AVAILABLE SESSIONS
+
+ID                    Date        Phase      Task
+────────────────────────────────────────────────────────
+abc123-def456        2025-01-24  implement  Add user auth
+def789-ghi012        2025-01-23  research   Fix payment bug
+jkl345-mno678        2025-01-22  plan       Refactor API
+
+Use: /session-resume <ID>
+```
+
+## Integration with RPI
+
+When resuming during an RPI workflow:
+- **Research phase**: Shows research document path
+- **Plan phase**: Shows plan document path
+- **Implement phase**: Shows current step and remaining steps
+
+## Configuration
+
+In `.ai-context/settings.json`:
+```json
+{
+  "session": {
+    "max_history_days": 30,
+    "auto_archive_completed": true
+  }
+}
+```
+
+## Related Commands
+
+- `/session-save` - Save current session
+- `/collab handoff` - Create team handoff
+- `/rpi-research` - Start research phase
+- `/rpi-plan` - Start plan phase
+- `/rpi-implement` - Start implement phase

package/templates/base/commands/session-save.md

@@ -0,0 +1,112 @@
+---
+name: session-save
+description: Save current session state for later resumption
+version: 1.0.0
+category: session
+context_budget: 5000
+outputs:
+  - session/current/state.json
+  - session/checkpoints/*.json (if checkpoint created)
+---
+
+# /session-save
+
+Save the current session state including task context, loaded files, and pending documentation updates.
+
+## Syntax
+
+```
+/session-save [--checkpoint "description"]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--checkpoint "desc"` | Create a named checkpoint for easy resumption |
+
+## What Gets Saved
+
+| Data | Description |
+|------|-------------|
+| Session ID | Unique identifier for this session |
+| Phase | Current RPI phase (idle/research/plan/implement) |
+| Task | Active task name and description |
+| Files Loaded | List of files loaded into context |
+| Pending Updates | Documentation updates queued |
+| Checkpoints | Named resume points |
+
+## Examples
+
+### Basic Save
+```
+/session-save
+```
+Saves current state to `.ai-context/session/current/state.json`
+
+### Save with Checkpoint
+```
+/session-save --checkpoint "After completing user auth research"
+```
+Creates a named checkpoint for easy resumption later.
+
+## Automatic Saving
+
+Sessions are automatically saved:
+- Every 5 minutes (configurable in settings.json)
+- On RPI phase transitions
+- Before context compaction
+
+## Resume Later
+
+Use `/session-resume` to restore this session.
+
+## Session Location
+
+```
+.ai-context/session/
+├── current/
+│   └── state.json       # Current session state
+├── history/
+│   └── YYYY-MM-DD/      # Archived sessions by date
+└── checkpoints/
+    └── {id}.json        # Named checkpoints
+```
+
+## Process
+
+1. **Collect State**
+   - Gather current phase, task, loaded files
+   - Collect pending documentation updates
+   - Record context usage metrics
+
+2. **Save to File**
+   - Write to session/current/state.json
+   - Optionally create checkpoint file
+
+3. **Confirm**
+   - Display summary of saved state
+   - Show pending updates count
+
+## Output Format
+
+```
+SESSION SAVED
+
+Session: abc123-def456
+Started: 2025-01-24 10:30:00
+Phase: implement
+Task: Add user authentication
+
+Files Loaded: 12
+Pending Updates: 3
+Checkpoints: 2
+
+Use '/session-resume' to restore this session.
+```
+
+## Related Commands
+
+- `/session-resume` - Resume a saved session
+- `/collab handoff` - Create team handoff document
+- `/auto-sync` - Process pending documentation updates

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