create-claude-context 1.0.0 → 1.2.1

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 `.claude/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 `.claude/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
+
+```
+.claude/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

@@ -1,77 +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
+---
+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

@@ -1,86 +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
+---
+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

@@ -1,57 +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
-    }
-  }
-}
+{
+  "$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
+    }
+  }
+}