context-engineer 1.1.0

package/templates/core/.context/conventions/git.md

@@ -0,0 +1,46 @@
+# Git Conventions
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Branch strategy, commit message conventions, PR process -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from git history analysis.]
+
+## Branch Strategy
+
+- **Main branch**: `main` (production-ready)
+- **Development branch**: [e.g., `develop` or direct to `main`]
+- **Feature branches**: `feature/[description]`
+- **Bug fix branches**: `fix/[description]`
+- **Release branches**: [if applicable]
+
+## Commit Message Convention
+
+```
+[type]([scope]): [short description]
+
+[optional body]
+
+[optional footer]
+```
+
+Types: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`, `perf`, `ci`
+
+## Pull Request Process
+
+1. Create a feature branch from `main`
+2. Make changes, ensure tests pass
+3. Create PR with description following template
+4. Request review from [team/person]
+5. Address feedback
+6. Squash merge to `main`
+
+## Protected Branches
+
+| Branch | Rules |
+|--------|-------|
+| `main` | [e.g., Require PR, require CI pass, require 1 approval] |

package/templates/core/.context/conventions/patterns.md

@@ -0,0 +1,41 @@
+# Design Patterns
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Design patterns, architectural patterns, and reusable code patterns used in this project -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from code analysis.]
+
+## Architectural Patterns
+
+### [Pattern Name, e.g., Repository Pattern]
+- **Where used**: [Which modules/layers]
+- **Implementation**: [Brief description]
+- **Example**: `[file path]`
+
+## Common Code Patterns
+
+### Error Handling Pattern
+```
+[Code example showing the standard error handling approach]
+```
+
+### Service Layer Pattern
+```
+[Code example showing how services are structured]
+```
+
+### Data Access Pattern
+```
+[Code example showing how data access is done]
+```
+
+## Anti-Patterns to Avoid
+
+| Anti-Pattern | Why It's Bad | What to Do Instead |
+|-------------|-------------|-------------------|
+| [Anti-pattern 1] | [Why] | [Alternative] |

package/templates/core/.context/conventions/testing.md

@@ -0,0 +1,49 @@
+# Testing Conventions
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Testing strategy, frameworks, conventions, and examples -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from test file analysis.]
+
+## Testing Stack
+
+| Type | Framework | Location |
+|------|-----------|----------|
+| Unit tests | [e.g., xUnit, Jest, pytest] | [e.g., tests/unit/] |
+| Integration tests | [e.g., same + TestContainers] | [e.g., tests/integration/] |
+| E2E tests | [e.g., Playwright, Cypress] | [e.g., tests/e2e/] |
+
+## Running Tests
+
+```bash
+# Run all tests
+[COMMAND]
+
+# Run unit tests only
+[COMMAND]
+
+# Run with coverage
+[COMMAND]
+
+# Run specific test file
+[COMMAND]
+```
+
+## Conventions
+
+1. **Test file naming**: [e.g., `*.test.ts`, `*Tests.cs`, `test_*.py`]
+2. **Test method naming**: [e.g., `Should_ExpectedResult_When_Condition`]
+3. **Arrange-Act-Assert**: Follow the AAA pattern
+4. **Independence**: Tests must not depend on execution order or shared state
+5. **Mocking**: [Preferred mocking library and approach]
+
+## Test Data
+
+- **Fixtures**: [Where test fixtures are located]
+- **Factories**: [How test data is generated]
+- **Cleanup**: [How test data is cleaned up]

package/templates/core/.context/experience/debugging.md

@@ -0,0 +1,21 @@
+# Debugging Guide
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Common issues, their symptoms, root causes, and resolutions. -->
+<!-- This file serves as a quick-reference troubleshooting guide for AI agents and developers. -->
+
+## Known Issues & Resolutions
+
+<!-- Add new entries at the top. Use the format below:
+
+### "[Error Message or Symptom]"
+- **Cause**: [Why this happens]
+- **Fix**: [How to resolve it]
+- **Prevention**: [How to avoid it in the future]
+
+-->
+
+[No entries yet. Debugging knowledge will be accumulated as issues are encountered and resolved.]

package/templates/core/.context/experience/incidents.md

@@ -0,0 +1,26 @@
+# Incident Post-Mortems
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Post-mortems and failure analyses from production incidents -->
+
+## Incidents
+
+<!-- Add new entries at the top:
+
+### YYYY-MM-DD: [Incident Title]
+- **Severity**: [P0/P1/P2/P3]
+- **Duration**: [How long the incident lasted]
+- **Impact**: [What was affected, how many users]
+- **Root Cause**: [What caused the incident]
+- **Resolution**: [How it was resolved]
+- **Action Items**:
+  - [ ] [Preventive action 1]
+  - [ ] [Preventive action 2]
+- **Lessons**: [Key takeaways → also add to lessons.md]
+
+-->
+
+[No incidents recorded yet.]

package/templates/core/.context/experience/lessons.md

@@ -0,0 +1,23 @@
+# Lessons Learned
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Accumulated lessons, anti-patterns discovered, and insights from development experience. -->
+<!-- When this file exceeds 500 lines, run scripts/compact-experience.sh to archive older entries. -->
+
+## Entries
+
+<!-- Add new entries at the top. Use the format below:
+
+### YYYY-MM-DD: [Short Title]
+- **Context**: [What was happening when this was discovered]
+- **Root Cause**: [Why it happened]
+- **Resolution**: [How it was fixed]
+- **Prevention**: [What was done to prevent recurrence, e.g., "Added to conventions/patterns.md"]
+- **Tags**: #tag1 #tag2
+
+-->
+
+[No entries yet. Lessons will be accumulated as the project evolves.]

package/templates/core/.context/experience/performance.md

@@ -0,0 +1,29 @@
+# Performance Insights
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Performance benchmarks, optimization discoveries, and tuning notes -->
+
+## Benchmarks
+
+<!-- Baseline performance metrics for key operations -->
+
+| Operation | Baseline | Target | Current |
+|-----------|----------|--------|---------|
+| [Operation] | [Time/Throughput] | [Target] | [Current] |
+
+## Optimization Notes
+
+<!-- Add new entries at the top:
+
+### YYYY-MM-DD: [Optimization Title]
+- **Before**: [Metric before optimization]
+- **After**: [Metric after optimization]
+- **What Changed**: [What was optimized]
+- **Tags**: #tag1 #tag2
+
+-->
+
+[No entries yet.]

package/templates/core/.context/index.md

@@ -0,0 +1,93 @@
+# Context Index
+
+> This is the master index for the project's context system.
+> AI agents should read this file first to understand what context is available and where to find it.
+
+## How to Use This Index
+
+1. Read `.context/constitution.md` for non-negotiable principles and the **Context Loading Route Table**
+2. Use the Route Table to determine which files to load based on your current task
+3. Only load files relevant to your task — do NOT load everything
+
+## Context Directory
+
+### Core (Always Read)
+| File | Description |
+|------|-------------|
+| [constitution.md](constitution.md) | Non-negotiable principles, constraints, and the Context Loading Route Table |
+
+### Business Domain
+| File | Description | Size Budget |
+|------|-------------|-------------|
+| [business/overview.md](business/overview.md) | What the product does, who it serves, why it exists | 300 lines |
+| [business/domain-model.md](business/domain-model.md) | Core business entities, relationships, ubiquitous language (DDD) | 500 lines |
+| [business/workflows.md](business/workflows.md) | Key processes, workflows, and technical pipelines | 400 lines |
+| [business/glossary.md](business/glossary.md) | Domain terminology definitions | 300 lines |
+
+### Technical Architecture
+| File | Description | Size Budget |
+|------|-------------|-------------|
+| [architecture/overview.md](architecture/overview.md) | System architecture, high-level design, subsystem breakdown | 800 lines |
+| [architecture/module-graph.md](architecture/module-graph.md) | Module/subsystem dependency graph and interfaces | 500 lines |
+| [architecture/data-flow.md](architecture/data-flow.md) | Data flow diagrams, pipelines, threading model | 500 lines |
+| [architecture/class-index.md](architecture/class-index.md) | Core classes/interfaces index (auto-generated) | 500 lines |
+| [architecture/data-model.md](architecture/data-model.md) | Database schema, entity relationships (auto-generated) | 500 lines |
+| [architecture/api-surface.md](architecture/api-surface.md) | API contracts, endpoints, protocols (auto-generated) | 500 lines |
+| [architecture/dependencies.md](architecture/dependencies.md) | External services, libraries, versions (auto-generated) | 300 lines |
+| [architecture/infrastructure.md](architecture/infrastructure.md) | Deployment, CI/CD, environments | 300 lines |
+| [architecture/decisions/](architecture/decisions/) | Architecture Decision Records (ADRs) | 200 lines each |
+
+### Coding Conventions
+| File | Description | Size Budget |
+|------|-------------|-------------|
+| [conventions/code-style.md](conventions/code-style.md) | Naming, formatting, language-specific rules | 300 lines |
+| [conventions/patterns.md](conventions/patterns.md) | Design patterns used in this project | 400 lines |
+| [conventions/testing.md](conventions/testing.md) | Testing strategy, conventions, examples | 300 lines |
+| [conventions/git.md](conventions/git.md) | Branch strategy, commit conventions, PR process | 200 lines |
+| [conventions/error-handling.md](conventions/error-handling.md) | Error handling patterns, logging conventions | 200 lines |
+
+### Architecture Decisions (ADRs)
+| File | Title | Status |
+|------|-------|--------|
+| [architecture/decisions/001-template.md](architecture/decisions/001-template.md) | Template | — |
+<!-- /sync and /update-context maintain this table automatically -->
+
+### Feature Specifications (OpenSpec-style)
+| Spec | Description |
+|------|-------------|
+<!-- No specs yet. Create specs/{feature}/spec.md to add one. -->
+<!-- /sync and /update-context maintain this table automatically -->
+
+### Active Changes
+| Change | Description |
+|--------|-------------|
+<!-- No active changes. Create changes/{name}/proposal.md to add one. -->
+<!-- /sync and /update-context maintain this table automatically -->
+
+### Experience & Knowledge
+| File | Description | Size Budget |
+|------|-------------|-------------|
+| [experience/lessons.md](experience/lessons.md) | Lessons learned, anti-patterns discovered | 500 lines |
+| [experience/debugging.md](experience/debugging.md) | Common issues and resolutions | 500 lines |
+| [experience/performance.md](experience/performance.md) | Performance insights, optimization notes | 300 lines |
+| [experience/incidents.md](experience/incidents.md) | Post-mortems, failure analyses | 300 lines |
+
+### Session Continuity (Ralph Loop-style)
+| File | Description |
+|------|-------------|
+| [progress/status.md](progress/status.md) | Current work-in-progress state |
+| [progress/backlog.md](progress/backlog.md) | Planned work items |
+
+### Development Workflow
+| File | Description |
+|------|-------------|
+| [workflow/config.md](workflow/config.md) | Pipeline configuration: phases, checkpoints, plugin overrides |
+| [workflow/artifacts/](workflow/artifacts/) | Transient phase outputs (requirements.md, prd.md, tasks.json, dep-graph.json, etc.) |
+
+### System Metadata
+| File | Description |
+|------|-------------|
+| [_meta/schema.md](_meta/schema.md) | Self-documenting schema for context files |
+| [_meta/last-sync.json](_meta/last-sync.json) | Last sync timestamps per file |
+| [_meta/concepts.md](_meta/concepts.md) | Concept-to-file inverted index (auto-generated) |
+| [_meta/drift-report.md](_meta/drift-report.md) | Latest drift detection results |

package/templates/core/.context/progress/backlog.md

@@ -0,0 +1,23 @@
+# Backlog
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Planned work items, prioritized. This serves as a lightweight task tracker for AI agent sessions. -->
+
+## Priority Queue
+
+<!-- Format:
+### [Priority] [Task Title]
+- **Description**: [What needs to be done]
+- **Context files**: [Which .context/ files are relevant]
+- **Estimated complexity**: [Low | Medium | High]
+- **Status**: [Pending | In Progress | Done]
+-->
+
+[No backlog items yet.]
+
+## Completed
+
+<!-- Move completed items here with completion date -->

package/templates/core/.context/progress/status.md

@@ -0,0 +1,30 @@
+# Work In Progress Status
+
+<!-- last-updated: YYYY-MM-DD -->
+<!-- This file is updated before context compaction to preserve session continuity -->
+
+## Current Task
+
+**Task**: [None]
+**Status**: [Not started | In progress | Blocked | Complete]
+**Branch**: [branch name if applicable]
+
+## What Was Done
+
+- [List of completed steps in current task]
+
+## What Remains
+
+- [List of remaining steps]
+
+## Blockers
+
+- [Any blockers or decisions needed]
+
+## Key Decisions Made This Session
+
+- [Important decisions or trade-offs made]
+
+## Files Modified
+
+- [List of files changed in this session]

package/templates/core/.context/workflow/config.md

@@ -0,0 +1,35 @@
+# Workflow Configuration
+
+<!-- TEMPLATE: This file configures the /dev automated development workflow pipeline. -->
+<!-- Customize checkpoints, execution settings, and plugin overrides for your project. -->
+
+## Pipeline Phases
+
+| Phase | ID | Checkpoint | Override |
+|-------|----|------------|----------|
+| Requirements Gathering | P0 | false | — |
+| PRD Generation | P1 | true | — |
+| Task Decomposition | P2 | true | — |
+| Dependency Analysis | P3 | false | — |
+| Agent Execution | P4 | false | — |
+| Quality Gate | P5 | false | — |
+| Commit & Integration | P6 | false | — |
+| Knowledge Capture | P7 | false | — |
+
+## Execution Settings
+
+- **max_parallel_agents**: 3
+- **isolation_strategy**: file-scope-first (fallback to worktree)
+- **quality_gate_commands**: (use constitution.md build/test commands)
+- **auto_commit**: false (require human confirmation)
+
+## Plugin Overrides
+
+<!-- Add project-specific overrides here. -->
+<!-- Priority: config override > convention directory (.claude/workflow/phases/) > built-in default -->
+<!--
+| Phase | Plugin Name | Type | Location |
+|-------|-------------|------|----------|
+| P5 | custom-e2e | skill | .claude/workflow/phases/quality-gate/SKILL.md |
+| P5 | api-tests | mcp | mcp-server-name |
+-->

package/templates/core/AGENTS.md

@@ -0,0 +1,53 @@
+# AGENTS.md
+
+> Universal entry point for all AI coding agents. This file is automatically read by Claude Code, Cursor, Windsurf, OpenAI Codex, GitHub Copilot, and other AI tools.
+
+## Project: [PROJECT_NAME]
+
+[One-line description of what this project does.]
+
+## Quick Start
+
+```bash
+# Install dependencies
+[INSTALL_COMMAND]
+
+# Build
+[BUILD_COMMAND]
+
+# Test
+[TEST_COMMAND]
+
+# Run locally
+[RUN_COMMAND]
+```
+
+## Context System
+
+This project uses a structured context system at `.context/`. **Do NOT try to understand the entire codebase at once.** Instead:
+
+1. **Always read** `.context/constitution.md` — it contains non-negotiable principles and a **Context Loading Route Table** that tells you which files to load based on your task type.
+2. **Read the route table** and load ONLY the files relevant to your current task.
+3. **Read** `.context/index.md` for a full directory of available context.
+
+## Context Maintenance
+
+When you modify code that affects any of the following, **update the corresponding `.context/` file in the same commit**:
+
+- Architecture → `architecture/overview.md`
+- Database schema → `architecture/data-model.md`
+- API endpoints → `architecture/api-surface.md`
+- Dependencies → `architecture/dependencies.md`
+- Coding patterns → `conventions/patterns.md`
+
+When you fix a non-trivial bug, record it in `experience/debugging.md`.
+
+## Key Conventions
+
+<!-- Fill in your project's most critical conventions (keep this under 10 items) -->
+
+1. [Convention 1]
+2. [Convention 2]
+3. [Convention 3]
+
+For full conventions, see `.context/conventions/`.

package/templates/core/scripts/compact-experience.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+#
+# compact-experience.sh — Compact experience files that exceed their size budgets
+#
+# Usage: bash scripts/compact-experience.sh [--dry-run]
+#
+# This script checks experience files for size budget violations and helps
+# archive older entries to keep the files within budget.
+
+set -euo pipefail
+
+CONTEXT_DIR=".context"
+EXPERIENCE_DIR="$CONTEXT_DIR/experience"
+ARCHIVE_DIR="$EXPERIENCE_DIR/archive"
+DRY_RUN=false
+BUDGET=500
+
+for arg in "$@"; do
+  case $arg in
+    --dry-run) DRY_RUN=true ;;
+  esac
+done
+
+echo "========================================="
+echo "  Experience Compaction"
+echo "========================================="
+echo ""
+
+# Check files and their sizes
+check_file() {
+  local file=$1
+  local name
+  name=$(basename "$file")
+
+  if [ ! -f "$file" ]; then
+    echo "  $name: not found (skip)"
+    return
+  fi
+
+  local lines
+  lines=$(wc -l < "$file")
+
+  if [ "$lines" -le "$BUDGET" ]; then
+    echo "  $name: ${lines}/${BUDGET} lines (OK)"
+  else
+    local excess=$((lines - BUDGET))
+    echo "  $name: ${lines}/${BUDGET} lines (OVER by $excess lines)"
+
+    if [ "$DRY_RUN" = true ]; then
+      echo "    → [DRY RUN] Would archive older entries"
+    else
+      echo "    → Creating archive..."
+      mkdir -p "$ARCHIVE_DIR"
+
+      local archive_file="$ARCHIVE_DIR/${name%.md}-$(date +%Y%m%d).md"
+
+      # Strategy: Keep the header and last BUDGET/2 entries, archive the rest
+      # This is a simple approach — the AI skills can do smarter compaction
+      echo "    → Archiving to $archive_file"
+      echo "    → NOTE: For intelligent compaction (merging related entries,"
+      echo "      promoting patterns to conventions), use the '/review-context' skill."
+      echo ""
+      echo "    Manual steps recommended:"
+      echo "    1. Review $file for entries that can be merged"
+      echo "    2. Move resolved/obsolete entries to $archive_file"
+      echo "    3. Promote frequently-referenced lessons to conventions/patterns.md"
+    fi
+  fi
+}
+
+echo "Checking experience file sizes (budget: $BUDGET lines)..."
+echo ""
+
+check_file "$EXPERIENCE_DIR/lessons.md"
+check_file "$EXPERIENCE_DIR/debugging.md"
+check_file "$EXPERIENCE_DIR/performance.md"
+check_file "$EXPERIENCE_DIR/incidents.md"
+
+echo ""
+echo "Done."
+if [ "$DRY_RUN" = true ]; then
+  echo "(Dry run — no changes made)"
+fi