context-engineer 1.1.0

package/templates/core/.context/architecture/data-model.md

@@ -0,0 +1,35 @@
+<!-- AUTO-GENERATED: Do not edit manually. Run scripts/sync-context.sh to regenerate. -->
+<!-- generated-from: [ORM models / migration files] -->
+<!-- generated-at: YYYY-MM-DDTHH:MM:SSZ -->
+
+# Data Model
+
+## Summary
+
+<!-- Database schema, tables/collections, entity relationships, indexes -->
+
+[PLACEHOLDER: Run `scripts/sync-context.sh` or `/bootstrap-context` to auto-generate from ORM models and migration files.]
+
+## Tables / Collections
+
+| Table | Description | Key Columns |
+|-------|-------------|-------------|
+| [table_name] | [What it stores] | [Primary key, important columns] |
+
+## Relationships
+
+| From | To | Type | FK Column |
+|------|----|------|-----------|
+| [Table1] | [Table2] | 1:N | [fk_column] |
+
+## Indexes
+
+| Table | Index Name | Columns | Type |
+|-------|-----------|---------|------|
+| [table] | [idx_name] | [columns] | [unique/btree/gin] |
+
+## Migrations
+
+- Latest migration: [name/number]
+- Migration tool: [e.g., EF Core Migrations, Prisma Migrate, Alembic]
+- Migration command: `[command to run migrations]`

package/templates/core/.context/architecture/decisions/001-template.md

@@ -0,0 +1,35 @@
+# ADR-001: [Decision Title]
+
+<!-- last-updated: YYYY-MM-DD -->
+
+## Status
+
+Proposed
+
+<!-- Proposed | Accepted | Deprecated | Superseded by ADR-XXX -->
+
+## Context
+
+[What is the issue that we're seeing that is motivating this decision or change?]
+
+## Decision
+
+[What is the change that we're proposing and/or doing?]
+
+## Alternatives Considered
+
+| Alternative | Pros | Cons |
+|------------|------|------|
+| [Option A] | [Pros] | [Cons] |
+| [Option B] | [Pros] | [Cons] |
+
+## Consequences
+
+### Positive
+- [What becomes easier]
+
+### Negative
+- [What becomes harder]
+
+### Risks
+- [What could go wrong]

package/templates/core/.context/architecture/dependencies.md

@@ -0,0 +1,35 @@
+<!-- AUTO-GENERATED: Do not edit manually. Run scripts/sync-context.sh to regenerate. -->
+<!-- generated-from: [package manifest files] -->
+<!-- generated-at: YYYY-MM-DDTHH:MM:SSZ -->
+
+# Dependencies
+
+## Summary
+
+<!-- External services, libraries, and their versions -->
+
+[PLACEHOLDER: Run `scripts/sync-context.sh` or `/bootstrap-context` to auto-generate from package manifest files.]
+
+## Runtime Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| [package-name] | [version] | [What it's used for] |
+
+## Development Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| [package-name] | [version] | [What it's used for] |
+
+## External Services
+
+| Service | Purpose | Environment Variable |
+|---------|---------|---------------------|
+| [e.g., PostgreSQL] | [Primary database] | `DATABASE_URL` |
+| [e.g., Redis] | [Caching] | `REDIS_URL` |
+| [e.g., AWS S3] | [File storage] | `AWS_S3_BUCKET` |
+
+## Version Constraints
+
+[Any important version pinning or compatibility notes]

package/templates/core/.context/architecture/infrastructure.md

@@ -0,0 +1,42 @@
+# Infrastructure
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Deployment strategy, CI/CD pipelines, environments, and infrastructure configuration -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate, or fill in manually.]
+
+## Environments
+
+| Environment | URL | Purpose | Deploy Method |
+|-------------|-----|---------|---------------|
+| Local | `localhost:[PORT]` | Development | Manual |
+| Dev/Staging | [URL] | Testing | [Auto/Manual] |
+| Production | [URL] | Live | [Auto/Manual] |
+
+## CI/CD Pipeline
+
+- **Platform**: [e.g., GitHub Actions, Azure DevOps, GitLab CI]
+- **Trigger**: [e.g., Push to main, PR merge]
+- **Steps**:
+  1. [Build]
+  2. [Test]
+  3. [Lint]
+  4. [Deploy]
+
+## Infrastructure
+
+- **Hosting**: [e.g., AWS, Azure, GCP, Docker, K8s]
+- **Database**: [Managed/Self-hosted, backup strategy]
+- **CDN**: [If applicable]
+- **Monitoring**: [e.g., Datadog, Prometheus, Application Insights]
+
+## Environment Variables
+
+| Variable | Description | Required | Default |
+|----------|-------------|----------|---------|
+| `[VAR_NAME]` | [Description] | [Yes/No] | [Default value] |

package/templates/core/.context/architecture/module-graph.md

@@ -0,0 +1,68 @@
+# Module Graph
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- High-level map of all modules/subsystems, their responsibilities, and dependency relationships -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from project structure analysis.]
+
+## Subsystems
+
+| Module | Directory | Responsibility | Key Classes |
+|--------|-----------|---------------|-------------|
+| [ModuleName] | [src/module/] | [One-line description] | [Class1, Class2, Class3] |
+
+## Dependency Graph
+
+```
+[ASCII dependency diagram showing module relationships]
+
+Example:
+ModuleA ──→ ModuleB ──→ ModuleC
+   │            │
+   └──→ ModuleD ──→ ModuleE
+
+Legend:
+  ──→  depends on (uses/calls)
+  ──▷  implements/extends
+  - - → optional/weak dependency
+```
+
+## Module Interfaces
+
+<!-- For each module: key public entry points, what it depends on, and what depends on it -->
+
+### [Module Name]
+
+**Public Interface**:
+- `ClassName::method(params)` — One-line description
+- `ClassName::method(params)` — One-line description
+
+**Depends on**: [Module1, Module2]
+**Depended by**: [Module3, Module4]
+
+---
+
+### [Module Name 2]
+
+**Public Interface**:
+- `ClassName::method(params)` — One-line description
+
+**Depends on**: [Module1]
+**Depended by**: [Module5]
+
+## Circular Dependencies
+
+<!-- List any circular dependencies detected, with notes on whether they are intentional -->
+
+None detected. <!-- Or: ModuleA ↔ ModuleB (via shared types) — intentional -->
+
+## Namespace / Directory Mapping
+
+| Namespace / Package | Directory | File Count |
+|---------------------|-----------|------------|
+| [com.example.module] | [src/module/] | [N] |

package/templates/core/.context/architecture/overview.md

@@ -0,0 +1,87 @@
+# Architecture Overview
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- High-level system architecture: what components exist, how they interact, key design decisions -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from project structure analysis.]
+
+## Tech Stack
+
+| Layer | Technology | Version |
+|-------|-----------|---------|
+| Language | [e.g., C# / TypeScript / Python] | [version] |
+| Framework | [e.g., ASP.NET Core / Express / FastAPI] | [version] |
+| Database | [e.g., PostgreSQL / MongoDB / SQL Server] | [version] |
+| ORM | [e.g., EF Core / Prisma / SQLAlchemy] | [version] |
+| Frontend | [e.g., React / Vue / Angular] | [version] |
+| Testing | [e.g., xUnit / Jest / pytest] | [version] |
+
+## System Architecture
+
+```
+[High-level architecture diagram using ASCII or Mermaid]
+
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Client    │────▶│  API Layer  │────▶│  Database   │
+│  (Browser)  │     │  (REST/gRPC)│     │ (PostgreSQL)│
+└─────────────┘     └──────┬──────┘     └─────────────┘
+                           │
+                    ┌──────▼──────┐
+                    │   Service   │
+                    │    Layer    │
+                    └─────────────┘
+```
+
+## Directory Structure
+
+```
+src/
+├── [layer1]/          # [Description]
+├── [layer2]/          # [Description]
+└── [layer3]/          # [Description]
+```
+
+## Key Design Decisions
+
+- **[Decision 1]**: [Brief rationale — see ADR-001 for details]
+- **[Decision 2]**: [Brief rationale — see ADR-002 for details]
+
+## Subsystem Breakdown
+
+<!-- One-line description of each major subsystem/module and its directory location.
+     For detailed dependency relationships, see architecture/module-graph.md -->
+
+| Subsystem | Directory | Responsibility |
+|-----------|-----------|---------------|
+| [Subsystem1] | [src/subsystem1/] | [What it does] |
+| [Subsystem2] | [src/subsystem2/] | [What it does] |
+
+## Key Interfaces Between Subsystems
+
+<!-- The most important interfaces/contracts that define module boundaries.
+     For the complete class index, see architecture/class-index.md -->
+
+- **[Subsystem1] → [Subsystem2]**: [Interface/class name] — [What this boundary defines]
+- **[Subsystem2] → [Subsystem3]**: [Interface/class name] — [What this boundary defines]
+
+## Threading / Concurrency Model
+
+<!-- How the application uses threads, async tasks, or processes.
+     For detailed data flow across threads, see architecture/data-flow.md -->
+
+- **Main Thread**: [What runs here]
+- **Worker Threads**: [What runs here, how many]
+- **Synchronization**: [Mutexes, channels, message queues, etc.]
+
+## Cross-Cutting Concerns
+
+- **Authentication**: [How auth works]
+- **Authorization**: [How permissions are enforced]
+- **Logging**: [Logging strategy]
+- **Error Handling**: [See conventions/error-handling.md]
+- **Caching**: [Caching strategy if applicable]

package/templates/core/.context/business/domain-model.md

@@ -0,0 +1,43 @@
+# Domain Model
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Core business entities, their relationships, and the ubiquitous language (DDD) -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from ORM models and code analysis.]
+
+## Core Entities
+
+| Entity | Description | Key Attributes |
+|--------|-------------|----------------|
+| [Entity1] | [What it represents] | [Key fields] |
+
+## Entity Relationships
+
+```
+[Entity1] 1──* [Entity2]
+[Entity2] *──* [Entity3]
+```
+
+<!-- Or use Mermaid diagram:
+```mermaid
+erDiagram
+    Entity1 ||--o{ Entity2 : has
+    Entity2 }o--o{ Entity3 : relates
+```
+-->
+
+## Ubiquitous Language
+
+| Term | Definition | Code Representation |
+|------|------------|---------------------|
+| [Business Term] | [What it means in business context] | [Class/type name in code] |
+
+## Invariants & Business Rules
+
+1. [Rule 1: e.g., "An Order must have at least one OrderItem"]
+2. [Rule 2: e.g., "A User cannot belong to more than 5 Organizations"]

package/templates/core/.context/business/glossary.md

@@ -0,0 +1,23 @@
+# Domain Glossary
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Domain-specific terminology definitions to ensure consistent language across code and communication -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from code analysis.]
+
+## Terms
+
+| Term | Definition | Also Known As | Used In |
+|------|------------|---------------|---------|
+| [Term 1] | [Precise definition] | [Aliases] | [Which code modules/areas] |
+
+## Abbreviations
+
+| Abbreviation | Full Form | Context |
+|-------------|-----------|---------|
+| [ABBR] | [Full form] | [Where it's used] |

package/templates/core/.context/business/overview.md

@@ -0,0 +1,29 @@
+# Business Overview
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- 3-5 line summary: What does this product do? Who does it serve? Why does it exist? -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from existing code and documentation, or fill in manually.]
+
+## Product Vision
+
+[What is the long-term vision for this product?]
+
+## Target Users
+
+| User Role | Description | Key Needs |
+|-----------|-------------|-----------|
+| [Role 1] | [Who they are] | [What they need] |
+
+## Core Value Proposition
+
+[What unique value does this product provide?]
+
+## Business Constraints
+
+[Budget, timeline, regulatory, compliance, or other business constraints that affect technical decisions]

package/templates/core/.context/business/workflows.md

@@ -0,0 +1,61 @@
+# Key Processes & Workflows
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Key processes and flows that drive the application.
+     For web/business apps: business workflows (user registration, checkout, etc.)
+     For engines/frameworks: technical pipelines (render pipeline, build pipeline, etc.)
+     For CLI/tools: processing workflows (input → transform → output) -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate, or fill in manually.]
+
+## Core Workflows
+
+<!-- Use this section for business/user-facing processes -->
+
+### [Workflow Name 1]
+
+**Trigger**: [What initiates this workflow]
+**Actors**: [Who/what is involved — users, services, or system components]
+**Steps**:
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+**Success Criteria**: [What defines successful completion]
+**Error Cases**: [What can go wrong and how it's handled]
+
+---
+
+## Technical Pipelines
+
+<!-- Use this section for internal processing pipelines and data flows.
+     For detailed pipeline diagrams, see architecture/data-flow.md -->
+
+### [Pipeline Name 1]
+
+**Purpose**: [What this pipeline achieves]
+**Trigger**: [Per frame / per request / on event / on demand]
+**Stages**:
+
+```
+[Input] → [Stage 1] → [Stage 2] → [Stage 3] → [Output]
+```
+
+**Key constraints**: [Timing, ordering, thread-safety requirements]
+
+---
+
+### [Pipeline Name 2]
+
+**Purpose**: [What this pipeline achieves]
+**Trigger**: [When this runs]
+**Stages**:
+
+```
+[Input] → [Stage 1] → [Stage 2] → [Output]
+```

package/templates/core/.context/constitution.md

@@ -0,0 +1,84 @@
+# Project Constitution
+
+> Non-negotiable principles and the Context Loading Route Table.
+> This file is part of the "hot memory" tier — it should always be loaded.
+
+<!-- TEMPLATE: Replace the placeholders below with your project's actual values -->
+
+## Project Identity
+
+- **Project Name**: [PROJECT_NAME]
+- **Tech Stack**: [e.g., .NET 8 / ASP.NET Core / EF Core / PostgreSQL]
+- **Primary Language**: [e.g., C#, TypeScript, Python]
+- **Repository**: [URL]
+
+## Non-Negotiable Principles
+
+<!-- Add your project's non-negotiable constraints here. Examples: -->
+
+1. **Security First**: Never store secrets in code. All sensitive data must use environment variables or a secret manager.
+2. **Type Safety**: Use strict typing. Avoid `any` (TypeScript), `dynamic` (C#), or equivalent escape hatches.
+3. **Test Coverage**: All new features must include unit tests. Critical paths must have integration tests.
+4. **No Direct DB Access from Controllers**: All database operations go through service/repository layers.
+5. **Immutable Infrastructure**: Configuration changes must go through version-controlled config files, never manual edits.
+
+## Build & Test Commands
+
+```bash
+# Build
+[BUILD_COMMAND]
+
+# Test
+[TEST_COMMAND]
+
+# Lint
+[LINT_COMMAND]
+
+# Run locally
+[RUN_COMMAND]
+```
+
+## Context Loading Route Table
+
+**IMPORTANT**: Use this table to determine which `.context/` files to load based on your current task. Do NOT load all files — only load what is relevant.
+
+| Task Type | Load These Files |
+|-----------|-----------------|
+| New feature development | `business/domain-model.md`, `specs/{feature}/spec.md`, `conventions/patterns.md` |
+| Bug fix | `experience/debugging.md`, `experience/lessons.md`, `architecture/overview.md` |
+| Database / Schema change | `architecture/data-model.md`, `conventions/patterns.md` |
+| API endpoint development | `architecture/api-surface.md`, `conventions/code-style.md` |
+| Refactoring | `architecture/overview.md`, `conventions/patterns.md`, `conventions/code-style.md` |
+| Testing | `conventions/testing.md` |
+| CI/CD or deployment | `architecture/infrastructure.md` |
+| Performance optimization | `experience/performance.md`, `architecture/overview.md` |
+| New developer onboarding | `business/overview.md`, `business/glossary.md`, `architecture/overview.md` |
+| Module restructuring | `architecture/module-graph.md`, `architecture/overview.md` |
+| Pipeline / flow changes | `architecture/data-flow.md`, `architecture/module-graph.md` |
+| Adding new subsystem | `architecture/module-graph.md`, `conventions/patterns.md`, `architecture/overview.md` |
+| Understanding codebase | `_meta/concepts.md`, `architecture/module-graph.md`, `architecture/data-flow.md`, `architecture/class-index.md` |
+| Concept / topic lookup | `_meta/concepts.md` |
+| Context system maintenance | `_meta/schema.md`, `index.md` |
+| Workflow execution (`/dev`) | `workflow/config.md`, `conventions/patterns.md`, `conventions/testing.md`, `conventions/git.md` |
+
+## Context Maintenance Rules
+
+1. **When you modify code that changes architecture, data models, API surfaces, or conventions**, you MUST update the corresponding `.context/` file in the same commit.
+2. **When you fix a non-trivial bug**, append the issue and resolution to `experience/debugging.md`.
+3. **When you make a significant architectural decision**, create an ADR in `architecture/decisions/`.
+4. **When you discover a new pattern or anti-pattern**, record it in `experience/lessons.md`.
+5. **Auto-generated files** (marked `<!-- AUTO-GENERATED -->`) should NOT be edited manually — regenerate them using `scripts/sync-context.sh`.
+
+## File Size Budgets
+
+| Category | Max Lines Per File |
+|----------|-------------------|
+| constitution.md | 200 |
+| AGENTS.md | 150 |
+| Business context files | 500 |
+| Architecture overview | 800 |
+| Architecture context files (other) | 500 |
+| Convention files | 400 |
+| ADR files | 200 |
+| Experience files | 500 (compact when exceeded) |
+| Spec files | 500 |

package/templates/core/.context/conventions/code-style.md

@@ -0,0 +1,47 @@
+# Code Style
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Naming conventions, formatting rules, and language-specific style guidelines -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from code analysis.]
+
+## Naming Conventions
+
+| Element | Convention | Example |
+|---------|-----------|---------|
+| Files | [e.g., kebab-case, PascalCase] | [example] |
+| Classes/Types | [e.g., PascalCase] | `UserService` |
+| Functions/Methods | [e.g., camelCase] | `getUserById` |
+| Variables | [e.g., camelCase] | `currentUser` |
+| Constants | [e.g., UPPER_SNAKE] | `MAX_RETRIES` |
+| Database tables | [e.g., snake_case] | `user_profiles` |
+| API endpoints | [e.g., kebab-case] | `/api/user-profiles` |
+
+## File Organization
+
+```
+[Describe the standard file structure for a typical module/feature]
+```
+
+## Formatting
+
+- **Indentation**: [tabs/spaces, size]
+- **Line length**: [max characters]
+- **Quotes**: [single/double]
+- **Semicolons**: [yes/no, for JS/TS]
+- **Trailing commas**: [yes/no]
+
+## Imports / Using Statements
+
+[Order and grouping conventions for imports]
+
+## Comments
+
+- Use comments only when the logic is not self-evident
+- Do NOT add comments to explain what code does — make the code itself readable
+- DO add comments to explain WHY something is done a certain way

package/templates/core/.context/conventions/error-handling.md

@@ -0,0 +1,50 @@
+# Error Handling Conventions
+
+<!-- confidence: low -->
+<!-- source: [TO BE FILLED BY BOOTSTRAP] -->
+<!-- last-updated: YYYY-MM-DD -->
+
+## Summary
+
+<!-- Error handling patterns, logging conventions, and error reporting -->
+
+[PLACEHOLDER: Run `/bootstrap-context` to auto-generate from code analysis.]
+
+## Error Handling Strategy
+
+### Application Errors
+- [How custom errors/exceptions are defined]
+- [Error hierarchy if applicable]
+
+### API Error Responses
+```json
+{
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "Human-readable message",
+    "details": {}
+  }
+}
+```
+
+### HTTP Status Code Usage
+| Status | When to Use |
+|--------|------------|
+| 400 | Validation errors, bad request |
+| 401 | Unauthenticated |
+| 403 | Unauthorized (no permission) |
+| 404 | Resource not found |
+| 409 | Conflict (duplicate, etc.) |
+| 422 | Unprocessable entity |
+| 500 | Unexpected server error |
+
+## Logging
+
+- **Framework**: [e.g., Serilog, Winston, Python logging]
+- **Levels**: DEBUG, INFO, WARN, ERROR, FATAL
+- **Structured logging**: [Yes/No, format]
+- **Sensitive data**: NEVER log passwords, tokens, PII
+
+## Monitoring & Alerting
+
+[How errors are tracked and alerted on]