k0ntext 3.0.0

package/templates/base/commands/collab.md

@@ -0,0 +1,194 @@
+---
+name: collab
+version: "1.0.0"
+displayName: "Team Collaboration"
+description: "Team collaboration tools for handoffs, knowledge sync, and status"
+category: "team"
+complexity: "low"
+context_budget: "~10K tokens"
+typical_context_usage: "5%"
+prerequisites:
+  - ".ai-context/team/config.json exists"
+  - "Team configuration completed"
+outputs:
+  - "Session handoff document (handoff)"
+  - "Sync status report (sync)"
+  - "Team status overview (status)"
+related_agents: []
+examples:
+  - command: "/collab handoff"
+    description: "Create session handoff for next team member"
+  - command: "/collab sync"
+    description: "Synchronize shared knowledge base"
+  - command: "/collab status"
+    description: "View team configuration and status"
+---
+
+# /collab - Team Collaboration Command
+
+Manage team collaboration features including session handoffs, knowledge synchronization, and team status.
+
+## Subcommands
+
+### `/collab handoff`
+
+Create a session handoff document for the next team member.
+
+**Workflow:**
+1. Collect session information:
+   - Files modified in session
+   - Git status and recent commits
+   - Open tasks and blockers
+2. Prompt for additional context:
+   - Work in progress description
+   - Blockers encountered
+   - Recommended next steps
+3. Generate handoff document from template
+4. Save to `.ai-context/knowledge/sessions/`
+5. Display handoff summary
+
+**Output:** `.ai-context/knowledge/sessions/YYYY-MM-DD-HH-MM-{member-id}.md`
+
+### `/collab sync`
+
+Synchronize and validate the shared knowledge base.
+
+**Workflow:**
+1. Scan knowledge directories:
+   - `shared/decisions/` - ADRs
+   - `shared/patterns/` - Patterns
+   - `sessions/` - Recent handoffs
+2. Validate document structure
+3. Check for stale content (>30 days unchanged)
+4. Report sync status:
+   - Documents found
+   - Validation issues
+   - Stale content warnings
+5. Optionally notify team of updates
+
+**Output:** Sync status report to console
+
+### `/collab status`
+
+Display team configuration and current status.
+
+**Workflow:**
+1. Load team configuration from `.ai-context/team/config.json`
+2. Display:
+   - Team name and organization
+   - Active members and roles
+   - Current policies
+   - Integration status
+3. Check for configuration issues
+4. Show recent activity summary
+
+**Output:** Team status report to console
+
+## Usage Examples
+
+### End of Session Handoff
+
+```
+User: /collab handoff
+
+Claude: Creating session handoff...
+
+## Session Summary
+Please describe what you worked on this session:
+
+User: Implemented user authentication flow, added login/logout endpoints
+
+Claude: ## Work In Progress
+Any incomplete work to note?
+
+User: JWT refresh token logic needs testing
+
+Claude: ## Blockers
+Any blockers for the next person?
+
+User: None
+
+Claude: ## Next Steps
+Recommended priorities for next session?
+
+User: 1. Test refresh tokens 2. Add password reset
+
+Claude: Session handoff created: .ai-context/knowledge/sessions/2024-01-15-16-30-dev-1.md
+
+### Handoff Summary
+- Session: 2024-01-15 16:30
+- Files Modified: 8
+- Commits: 3
+- Status: Ready for handoff
+
+The next team member can review this handoff to continue your work.
+```
+
+### Sync Knowledge Base
+
+```
+User: /collab sync
+
+Claude: Synchronizing knowledge base...
+
+### Scan Results
+- ADRs: 3 documents
+- Patterns: 5 documents
+- Sessions: 12 handoffs
+
+### Validation
+✓ All ADRs have required sections
+✓ All patterns follow template
+⚠ 2 session handoffs > 30 days old
+
+### Recommendations
+- Archive or delete old handoffs:
+  - sessions/2023-12-01-14-00-dev-2.md
+  - sessions/2023-12-05-09-15-dev-1.md
+
+Knowledge base sync complete.
+```
+
+### Check Team Status
+
+```
+User: /collab status
+
+Claude: ## Team Status
+
+### Configuration
+- Team: Engineering Team
+- Organization: Acme Corp
+- Version: 1.0.0
+
+### Members (3 active)
+| Name | Role | Status |
+|------|------|--------|
+| Alice | team-lead | active |
+| Bob | developer | active |
+| Carol | developer | active |
+
+### Policies
+- Code review required: Yes
+- Documentation updates required: Yes
+- Test coverage minimum: 80%
+
+### Integrations
+- Slack: Configured ✓
+- Jira: Not configured
+- Confluence: Not configured
+
+### Recent Activity
+- Last handoff: 2024-01-15 by Bob
+- Knowledge updates: 2 this week
+```
+
+## Configuration
+
+Requires `.ai-context/team/config.json` to be configured. See `.ai-context/team/README.md` for setup instructions.
+
+## Related
+
+- [Team Configuration](./../team/README.md)
+- [Knowledge Base](./../knowledge/README.md)
+- [Session Handoff Template](./../knowledge/sessions/TEMPLATE.md)

package/templates/base/commands/context-optimize.md

@@ -0,0 +1,226 @@
+---
+name: context-optimize
+version: "1.0.0"
+description: "Orchestrate context engineering optimization with interactive scoping and RPI workflow TODO generation"
+category: "orchestration"
+context_budget_estimate: "40K tokens"
+typical_context_usage: "20%"
+prerequisites: []
+outputs:
+  - "Optimization TODO checklist in .ai-context/plans/active/context-optimization_plan.md"
+  - "Context enhancement recommendations"
+  - "Redundant file identification report"
+  - "Agent/command creation suggestions based on user scope"
+next_commands: ["/rpi-research", "/rpi-plan", "/rpi-implement"]
+related_agents: ["context-engineer"]
+examples:
+  - command: "/context-optimize"
+    description: "Start interactive context optimization workflow"
+  - command: "/context-optimize --auto"
+    description: "Run optimization with automatic scoping"
+  - command: "/context-optimize --scope documentation"
+    description: "Focus optimization on documentation only"
+exit_criteria:
+  - "User scope defined through up to 4 questions"
+  - "TODO checklist generated with RPI phases"
+  - "Redundant files identified"
+  - "Enhancement opportunities documented"
+  - "Action plan ready for execution"
+---
+
+# Context Optimization Command
+
+**Purpose:** Orchestrate the context engineer agent to create a comprehensive TODO list for running RPI workflow, functionalize the context engineering system, and identify enhancement opportunities.
+
+**Syntax:** `/context-optimize [--auto|--scope <area>]`
+
+---
+
+## What This Command Does
+
+1. **Interactive Scoping** - Asks up to 4 multiple choice questions to understand your optimization goals
+2. **Context Audit** - Analyzes the current context engineering setup for the codebase
+3. **RPI TODO Generation** - Creates actionable TODO list with research, plan, implement phases
+4. **Redundancy Detection** - Identifies redundant or outdated files in the context system
+5. **Enhancement Suggestions** - Recommends specific agents or commands to add based on codebase needs
+
+---
+
+## Execution Flow
+
+### Step 1: Interactive Scoping (Optional with --auto)
+
+Ask up to 4 multiple choice questions to define optimization scope:
+
+**Question 1: Optimization Focus**
+```
+What is your primary optimization goal?
+A) Functionalize the entire context engineering system
+B) Update outdated documentation and line references
+C) Identify and remove redundant context files
+D) Discover enhancement opportunities (new agents/commands)
+```
+
+**Question 2: Codebase Coverage**
+```
+Which areas of the codebase should be prioritized?
+A) Core business logic
+B) API/External integrations
+C) Database/Data layer
+D) All areas equally
+```
+
+**Question 3: Enhancement Preferences**
+```
+What types of enhancements would be most valuable?
+A) New specialized agents for specific domains
+B) New workflow commands for common tasks
+C) Improved documentation structure
+D) Better cross-referencing and navigation
+```
+
+**Question 4: TODO Priority Order**
+```
+How should the TODO list be structured?
+A) Quick wins first (< 30 min each)
+B) High impact first (regardless of effort)
+C) By workflow area (grouped logically)
+D) By dependency order (foundational first)
+```
+
+---
+
+### Step 2: Context System Audit
+
+**Actions:**
+1. Analyze `.ai-context/` directory structure
+2. Check workflow file coverage and accuracy
+3. Verify index file completeness
+4. Identify orphaned or outdated files
+5. Assess agent and command coverage gaps
+
+**Audit Checklist:**
+```
+[ ] AI_CONTEXT.md is current and accurate
+[ ] All workflow files have valid line references
+[ ] CODE_TO_WORKFLOW_MAP.md matches codebase structure
+[ ] All agents are properly documented
+[ ] All commands are functional
+[ ] Index files are complete and navigable
+[ ] Research/Plans directories are organized
+```
+
+---
+
+### Step 3: Generate RPI TODO List
+
+Based on scoping and audit, generate actionable TODO with RPI phases:
+
+**Output Format:**
+```markdown
+# Context Optimization TODO
+
+**Generated:** [timestamp]
+**Scope:** [user-selected scope]
+**Priority:** [user-selected priority]
+
+## Phase 1: RESEARCH Tasks
+
+- [ ] /rpi-research context-system-audit
+  - Discover all existing context files and their relationships
+  - Map current workflow coverage
+  - Identify gaps in documentation
+
+- [ ] /rpi-research [area-specific-task]
+  - [Description based on scoping]
+
+## Phase 2: PLAN Tasks
+
+- [ ] /rpi-plan context-restructure
+  - Define file reorganization strategy
+  - Plan redundant file cleanup
+  - Design enhanced navigation structure
+
+- [ ] /rpi-plan [enhancement-specific-task]
+  - [Description based on scoping]
+
+## Phase 3: IMPLEMENT Tasks
+
+- [ ] /rpi-implement context-updates
+  - Execute planned changes atomically
+  - Update all affected index files
+  - Validate with /verify-docs-current
+
+- [ ] /rpi-implement [new-agent-or-command]
+  - [Description based on scoping]
+
+## Post-Implementation
+
+- [ ] Run /validate-all
+- [ ] Archive completed plans
+- [ ] Update CHANGELOG.md
+```
+
+---
+
+### Step 4: Redundant File Detection
+
+**Detection Rules:**
+1. Files not referenced by any index
+2. Duplicate or overlapping content (>70% similarity)
+3. Outdated files with stale line references (>20% drift)
+4. Empty placeholder files without content
+5. Orphaned research/plan files older than 30 days
+
+**Output:**
+```
+REDUNDANT FILES DETECTED:
+
+⚠️  High Priority (should remove):
+- .ai-context/context/workflows/old_feature.md - Not in any index
+- .ai-context/research/completed/stale_research.md - 90 days old
+
+📋 Medium Priority (review needed):
+- .ai-context/context/DUPLICATE_FILE.md - 85% similar to other.md
+
+ℹ️  Low Priority (consider archiving):
+- .ai-context/plans/completed/ancient_plan.md - 60 days old
+```
+
+---
+
+### Step 5: Enhancement Recommendations
+
+**Analysis Categories:**
+
+1. **Agent Gaps**
+   - Identify domains without specialized agents
+   - Suggest new agents based on codebase patterns
+   ```
+   RECOMMENDED AGENTS:
+   - payment-specialist (Payments, Billing)
+   - data-pipeline-ops (ETL, analytics)
+   ```
+
+2. **Command Gaps**
+   - Identify missing commands for frequent tasks
+   - Suggest new commands based on patterns
+   ```
+   RECOMMENDED COMMANDS:
+   - /db-migrate (Database migration helper)
+   - /api-docs (Generate API documentation)
+   ```
+
+3. **Documentation Gaps**
+   - Identify undocumented workflows
+   - Recommend new workflow documentation
+
+---
+
+## Next Steps
+
+After completion, execute the generated TODO list:
+1. `/rpi-research [first-research-task]`
+2. `/rpi-plan [first-plan-task]`
+3. `/rpi-implement [first-impl-task]`
+4. `/validate-all`