create-universal-ai-context 2.4.0 → 2.6.0-final

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

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

@@ -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": ".ai-context/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": ".ai-context/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
+    }
+  }
+}