k0ntext 3.1.0 → 3.2.0

package/templates/base/agents/api-developer.md

@@ -74,3 +74,40 @@ This agent integrates with:
 - API contract consistency
 - Endpoint security checks
 - Response schema validation
+
+---
+
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext generate` | After API changes - regenerates API documentation for all AI tools |
+| `k0ntext drift-detect` | When API may have diverged from docs - AI-powered drift detection |
+| `k0ntext fact-check` | Validate API documentation accuracy - quality assurance for API specs |
+
+### Command Examples
+
+```bash
+# Generate contexts after API changes
+k0ntext generate --tools claude,cursor
+
+# Detect API documentation drift
+k0ntext drift-detect
+
+# Fact-check API endpoint documentation
+k0ntext fact-check
+
+# Search for existing API patterns
+k0ntext search "API endpoint"
+```
+
+### Workflow Integration
+
+When developing APIs:
+1. **Before changes:** Run `k0ntext search <resource>` to find existing endpoint patterns
+2. **During development:** Reference indexed API contracts and examples
+3. **After changes:** Use `k0ntext generate` to update all AI tool contexts
+4. **Before commit:** Run `k0ntext drift-detect` to identify documentation gaps
+5. **For QA:** Use `k0ntext fact-check` to validate documentation accuracy

package/templates/base/agents/context-engineer.md

@@ -511,6 +511,47 @@ After initialization, use the RPI workflow for all development:
 
 ---
 
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext init` | First-time project setup - initializes AI context with intelligent analysis |
+| `k0ntext generate` | After making architectural changes - regenerates context files for all AI tools |
+| `k0ntext validate` | Before committing changes - validates context file structure and completeness |
+| `k0ntext index` | After adding new files - indexes codebase content into the database for search |
+| `k0ntext stats` | Check database and indexing status - shows context items, embeddings, and database path |
+
+### Command Examples
+
+```bash
+# Initialize a new project with intelligent analysis
+k0ntext init
+
+# Generate contexts for specific AI tools
+k0ntext generate --tools claude,cursor
+
+# Validate context files
+k0ntext validate
+
+# Index new documentation files
+k0ntext index --docs
+
+# View database statistics
+k0ntext stats
+```
+
+### Workflow Integration
+
+When using this agent:
+1. **Before initialization:** Run `k0ntext init` to establish baseline context
+2. **During template population:** Use `k0ntext index` to discover all project files
+3. **After modifications:** Run `k0ntext generate` to propagate changes to all AI tools
+4. **Before commit:** Use `k0ntext validate` to ensure context integrity
+
+---
+
 ## Version History
 
 | Version | Date | Changes |

package/templates/base/agents/core-architect.md

@@ -74,3 +74,44 @@ This agent integrates with:
 - Architecture consistency checks
 - State machine validation
 - Dependency consistency verification
+
+---
+
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext init` | First-time project setup - analyzes architecture during initialization |
+| `k0ntext generate` | After architectural changes - regenerates context for all AI tools |
+| `k0ntext drift-detect` | When code may have diverged from architecture docs - AI-powered drift detection |
+| `k0ntext cross-sync` | After drift detected - intelligent cross-tool synchronization |
+| `k0ntext search <query>` | Finding related architecture decisions - search indexed content |
+
+### Command Examples
+
+```bash
+# Initialize with architecture analysis
+k0ntext init
+
+# Detect documentation drift
+k0ntext drift-detect
+
+# Cross-sync after detecting drift
+k0ntext cross-sync
+
+# Search for architecture patterns
+k0ntext search "authentication flow"
+
+# Generate contexts after architecture changes
+k0ntext generate --tools claude,cursor
+```
+
+### Workflow Integration
+
+When designing architecture:
+1. **Before design:** Run `k0ntext search <pattern>` to find existing architecture patterns
+2. **During design:** Reference discovered workflows and patterns
+3. **After changes:** Use `k0ntext drift-detect` to identify documentation that needs updating
+4. **Before commit:** Run `k0ntext cross-sync` to propagate changes across all AI tools

package/templates/base/agents/database-ops.md

@@ -74,3 +74,41 @@ This agent integrates with:
 - Schema consistency checks
 - Migration validation
 - Query performance benchmarks
+
+---
+
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext index` | After adding new tables/migrations - indexes database files for search |
+| `k0ntext search <query>` | Finding database-related code - search across indexed schema and migrations |
+| `k0ntext stats` | Check indexing status - view database items, embeddings, and file counts |
+| `k0ntext validate` | Before committing migrations - validates context file integrity |
+
+### Command Examples
+
+```bash
+# Index database-related files
+k0ntext index --code
+
+# Search for database patterns
+k0ntext search "user table schema"
+k0ntext search "migration"
+
+# View indexing statistics
+k0ntext stats
+
+# Validate context files
+k0ntext validate
+```
+
+### Workflow Integration
+
+When working with database operations:
+1. **Before changes:** Run `k0ntext search <table>` to find existing schema references
+2. **During design:** Reference indexed migrations and models
+3. **After migrations:** Use `k0ntext index` to update the search index
+4. **Before commit:** Run `k0ntext validate` to ensure documentation consistency

package/templates/base/agents/deployment-ops.md

@@ -74,3 +74,44 @@ This agent integrates with:
 - Pipeline reliability checks
 - Infrastructure consistency validation
 - Deployment strategy verification
+
+---
+
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext hooks` | Git hooks management - for automation during deployment workflows |
+| `k0ntext validate` | Before committing deployments - validates context file integrity |
+| `k0ntext export` | Export database - backup context before major deployments |
+| `k0ntext import` | Import context - restore context after rollback |
+
+### Command Examples
+
+```bash
+# Install git hooks for automated validation
+k0ntext hooks install
+
+# Validate deployment configuration
+k0ntext validate
+
+# Export context before deployment
+k0ntext export --file backup-before-deploy.json
+
+# Import context after rollback
+k0ntext import --file backup-before-deploy.json
+
+# Search for deployment patterns
+k0ntext search "deployment pipeline"
+```
+
+### Workflow Integration
+
+When managing deployments:
+1. **Before deployment:** Run `k0ntext export` to backup current context
+2. **During setup:** Use `k0ntext hooks install` for automated validation
+3. **After changes:** Run `k0ntext validate` to ensure configuration integrity
+4. **On rollback:** Use `k0ntext import` to restore previous context state
+5. **For patterns:** Search `k0ntext search <pattern>` to find deployment configurations

package/templates/base/agents/integration-hub.md

@@ -74,3 +74,40 @@ This agent integrates with:
 - Integration security checks
 - Authentication mechanism validation
 - Rate limiting configuration
+
+---
+
+## k0ntext CLI Commands
+
+This agent integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext sync` | After manual context changes - synchronize context across AI tools |
+| `k0ntext cross-sync` | After drift detected - intelligent cross-tool synchronization |
+| `k0ntext validate` | Before committing integrations - validates context file integrity |
+
+### Command Examples
+
+```bash
+# Sync context across all AI tools
+k0ntext sync
+
+# Intelligent cross-tool sync
+k0ntext cross-sync
+
+# Validate integration documentation
+k0ntext validate
+
+# Search for existing integrations
+k0ntext search "webhook"
+```
+
+### Workflow Integration
+
+When working with integrations:
+1. **Before adding:** Run `k0ntext search <service>` to find existing integration patterns
+2. **During setup:** Reference indexed webhook handlers and auth flows
+3. **After changes:** Use `k0ntext sync` to propagate changes to all AI tools
+4. **Before commit:** Run `k0ntext cross-sync` to ensure consistency across tools
+5. **For verification:** Use `k0ntext validate` to check documentation integrity

package/templates/base/commands/analytics.md

@@ -236,3 +236,36 @@ Configure analytics behavior in `.ai-context/settings.json`:
 
 - [Settings Configuration](./../settings.json)
 - [Context Budget Guidelines](./../README.md#context-budget)
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext stats` | View database and indexing statistics |
+| `k0ntext performance` | Show system performance metrics |
+| `k0ntext export` | Export analytics data to JSON file |
+
+### Command Examples
+
+```bash
+# View database statistics
+k0ntext stats
+
+# Show performance metrics
+k0ntext performance
+
+# Export analytics data
+k0ntext export --file analytics-data.json
+```
+
+### Workflow Integration
+
+When analyzing metrics:
+1. **Before analysis:** Run `k0ntext stats` to gather baseline data
+2. **During analysis:** Use `k0ntext performance` for detailed metrics
+3. **For reporting:** Use `k0ntext export` to export data for analysis
+4. **For trends:** Track stats over time to identify patterns

package/templates/base/commands/auto-sync.md

@@ -170,3 +170,36 @@ npx claude-context sync --check
 npx claude-context sync --fix
 npx claude-context generate --code-map
 ```
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext sync` | Sync context across AI tools |
+| `k0ntext cross-sync` | Intelligent cross-tool synchronization |
+| `k0ntext hooks` | Git hooks management for automatic sync |
+
+### Command Examples
+
+```bash
+# Sync across all AI tools
+k0ntext sync
+
+# Intelligent cross-tool sync
+k0ntext cross-sync
+
+# Install git hooks for auto-sync
+k0ntext hooks install
+```
+
+### Workflow Integration
+
+When synchronizing documentation:
+1. **Before sync:** Use `k0ntext drift-detect` to identify what needs syncing
+2. **During sync:** Use `k0ntext sync` to propagate changes
+3. **For automation:** Install git hooks with `k0ntext hooks install`
+4. **For cross-tool:** Use `k0ntext cross-sync` for intelligent synchronization

package/templates/base/commands/collab.md

@@ -192,3 +192,40 @@ Requires `.ai-context/team/config.json` to be configured. See `.ai-context/team/
 - [Team Configuration](./../team/README.md)
 - [Knowledge Base](./../knowledge/README.md)
 - [Session Handoff Template](./../knowledge/sessions/TEMPLATE.md)
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext sync` | Sync shared knowledge across AI tools |
+| `k0ntext cross-sync` | Intelligent cross-tool synchronization for teams |
+| `k0ntext export` | Export context for team handoff |
+| `k0ntext import` | Import context from team members |
+
+### Command Examples
+
+```bash
+# Sync across all AI tools
+k0ntext sync
+
+# Cross-tool sync for team consistency
+k0ntext cross-sync
+
+# Export for handoff
+k0ntext export --file handoff-data.json
+
+# Import from team member
+k0ntext import --file handoff-data.json
+```
+
+### Workflow Integration
+
+When collaborating with team:
+1. **Before handoff:** Run `k0ntext export` to package current context
+2. **During collaboration:** Use `k0ntext sync` to keep everyone aligned
+3. **For consistency:** Use `k0ntext cross-sync` for intelligent synchronization
+4. **After receiving:** Use `k0ntext import` to load handoff context

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

@@ -224,3 +224,39 @@ After completion, execute the generated TODO list:
 2. `/rpi-plan [first-plan-task]`
 3. `/rpi-implement [first-impl-task]`
 4. `/validate-all`
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext stats` | View context metrics and database statistics |
+| `k0ntext performance` | Show system performance metrics for optimization |
+| `k0ntext validate` | Validate context file structure after optimization |
+
+### Command Examples
+
+```bash
+# Check current database statistics
+k0ntext stats
+
+# View performance metrics
+k0ntext performance
+
+# Validate context structure
+k0ntext validate
+
+# Search for optimization patterns
+k0ntext search "performance"
+```
+
+### Workflow Integration
+
+When optimizing context:
+1. **Before optimization:** Run `k0ntext stats` to establish baseline metrics
+2. **During optimization:** Reference indexed patterns and configurations
+3. **After changes:** Use `k0ntext validate` to ensure context integrity
+4. **For metrics:** Use `k0ntext performance` to measure improvements

package/templates/base/commands/help.md

@@ -467,6 +467,61 @@ npx claude-context config
 
 ---
 
+## k0ntext CLI Commands
+
+The k0ntext CLI provides comprehensive context engineering commands. Here's a quick reference:
+
+| Command | Purpose |
+|---------|---------|
+| `k0ntext init` | Initialize project with intelligent analysis |
+| `k0ntext generate` | Generate context files for AI tools |
+| `k0ntext mcp` | Start MCP server for AI tools |
+| `k0ntext sync` | Sync context across AI tools |
+| `k0ntext cleanup` | Remove unused AI tool folders |
+| `k0ntext validate` | Validate context files |
+| `k0ntext export` | Export database to file |
+| `k0ntext import` | Import context from file |
+| `k0ntext performance` | Show performance metrics |
+| `k0ntext watch` | Auto-index on file changes |
+| `k0ntext drift-detect` | AI-powered drift detection |
+| `k0ntext cross-sync` | Intelligent cross-tool sync |
+| `k0ntext hooks` | Git hooks management |
+| `k0ntext fact-check` | Validate documentation accuracy |
+| `k0ntext index` | Index codebase into database |
+| `k0ntext search <query>` | Search indexed content |
+| `k0ntext stats` | View database statistics |
+
+### Command Details
+
+**Initialization Commands:**
+- `k0ntext init` - First-time setup with intelligent codebase analysis
+- `k0ntext generate` - Generate contexts for specific AI tools
+- `k0ntext mcp` - Start the MCP server for tool integration
+
+**Sync & Validation Commands:**
+- `k0ntext sync` - Propagate context changes across AI tools
+- `k0ntext validate` - Check context file structure and validity
+- `k0ntext drift-detect` - Detect documentation drift using AI
+- `k0ntext cross-sync` - Intelligent synchronization after drift
+- `k0ntext fact-check` - Validate documentation against code
+
+**Database Commands:**
+- `k0ntext index` - Index codebase files for semantic search
+- `k0ntext search <query>` - Search indexed content (text/semantic/hybrid)
+- `k0ntext stats` - View database statistics and indexing status
+
+**Utility Commands:**
+- `k0ntext export` - Export database to JSON file
+- `k0ntext import` - Import database from JSON file
+- `k0ntext cleanup` - Remove unused AI tool folders
+- `k0ntext performance` - Show system performance metrics
+- `k0ntext watch` - Auto-index on file changes
+- `k0ntext hooks` - Git hooks management
+
+For detailed documentation, see [CLI_COMMANDS.md](../CLI_COMMANDS.md)
+
+---
+
 ## Quick Tips
 
 1. **Start with indexes:** Load CATEGORY_INDEX.md before detail files

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

@@ -162,3 +162,39 @@ Documentation updates
 - All chunks marked IMPLEMENTED (plan + research)
 - Updated documentation per chunk
 - Documents archived to completed/
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext watch` | Auto-index on file changes during implementation |
+| `k0ntext validate` | Validate context files after changes |
+| `k0ntext fact-check` | Validate documentation accuracy before finalizing |
+
+### Command Examples
+
+```bash
+# Start watch mode for auto-indexing
+k0ntext watch
+
+# Validate context after changes
+k0ntext validate
+
+# Fact-check documentation updates
+k0ntext fact-check
+
+# Search for related tests
+k0ntext search "test"
+```
+
+### Workflow Integration
+
+When implementing changes:
+1. **Before implementing:** Start `k0ntext watch` for automatic indexing
+2. **During implementation:** Use search to find related tests and patterns
+3. **After each change:** Use `k0ntext validate` to ensure integrity
+4. **Before finalizing:** Run `k0ntext fact-check` to validate documentation

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

@@ -145,3 +145,35 @@ Plan document in `.ai-context/plans/active/[feature]_plan.md` with:
 After human approval: `/rpi-implement [feature-name]`
 
 RPI-Implement will process chunks in dependency order, executing todos atomically
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext search <query>` | Search for related code patterns during planning |
+| `k0ntext drift-detect` | Check for documentation drift before planning changes |
+
+### Command Examples
+
+```bash
+# Search for similar implementations
+k0ntext search "authentication flow"
+
+# Detect documentation drift
+k0ntext drift-detect
+
+# Search for API patterns
+k0ntext search "endpoint"
+```
+
+### Workflow Integration
+
+When creating implementation plans:
+1. **Before planning:** Use `k0ntext drift-detect` to identify documentation issues
+2. **During planning:** Search for related patterns and implementations
+3. **For reference:** Use semantic search to find similar code structures
+4. **After planning:** Document search results for implementation phase

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

@@ -143,3 +143,37 @@ REQUIRED_OUTPUT: CHUNK-Pn per CHUNK-Rn
 After completion: `/rpi-plan [feature-name]`
 
 RPI-Plan will read chunk manifest and create CHUNK-Pn todolist per CHUNK-Rn
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext index` | Index codebase before research for complete file discovery |
+| `k0ntext search <query>` | Search indexed content during research phase |
+| `k0ntext stats` | Check indexing status before starting research |
+
+### Command Examples
+
+```bash
+# Index codebase before research
+k0ntext index --all
+
+# Search for related code patterns
+k0ntext search "authentication"
+k0ntext search "API endpoint"
+
+# View indexing statistics
+k0ntext stats
+```
+
+### Workflow Integration
+
+When conducting RPI research:
+1. **Before research:** Run `k0ntext index` to ensure all files are indexed
+2. **During research:** Use `k0ntext search <query>` to find related code and patterns
+3. **For coverage:** Check `k0ntext stats` to verify indexing completeness
+4. **After research:** Indexed data aids the planning phase

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

@@ -142,3 +142,35 @@ In `.ai-context/settings.json`:
 - `/rpi-research` - Start research phase
 - `/rpi-plan` - Start plan phase
 - `/rpi-implement` - Start implement phase
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext import` | Import context database for session restoration |
+| `k0ntext search <query>` | Search for context from previous session |
+
+### Command Examples
+
+```bash
+# Import session database
+k0ntext import --file session-backup.json
+
+# Search for previous work
+k0ntext search "authentication"
+
+# Check database status
+k0ntext stats
+```
+
+### Workflow Integration
+
+When resuming a session:
+1. **Before resume:** Use `k0ntext import` to restore database if needed
+2. **During resume:** Use `k0ntext search` to find previous context
+3. **For verification:** Check `k0ntext stats` to confirm data restoration
+4. **For continuity:** Exported data provides session continuity

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

@@ -110,3 +110,32 @@ Use '/session-resume' to restore this session.
 - `/session-resume` - Resume a saved session
 - `/collab handoff` - Create team handoff document
 - `/auto-sync` - Process pending documentation updates
+
+---
+
+## k0ntext CLI Commands
+
+This command integrates with the following k0ntext CLI commands:
+
+| Command | When to Use |
+|---------|-------------|
+| `k0ntext export` | Export database for session backup |
+| `k0ntext stats` | View database statistics for session summary |
+
+### Command Examples
+
+```bash
+# Export database before session end
+k0ntext export --file session-backup.json
+
+# View statistics for session summary
+k0ntext stats
+```
+
+### Workflow Integration
+
+When saving session state:
+1. **Before save:** Run `k0ntext export` to backup current database
+2. **During save:** Include statistics from `k0ntext stats`
+3. **For handoff:** Export data can be shared with team members
+4. **For resume:** Use `k0ntext import` to restore session state