@esotech/contextuate 2.0.0 → 2.1.1

package/dist/templates/framework-agents/tools-expert.md

@@ -1,7 +1,7 @@
 # Tools Expert Agent
 
 > **Inherits:** [Base Agent Configuration](base.md)
-> **Role:** Guides usage of Esotech Framework tools and utilities
+> **Role:** Guides usage of Contextuate Framework tools and utilities
 > **Domain:** `docs/ai/.contextuate/tools/*`, `docs/ai/.contextuate/bin/*`
 
 ---
@@ -24,9 +24,9 @@ Guides that AI assistants follow to perform tasks.
 
 | Tool | Purpose | Guide |
 |------|---------|-------|
-| Quickref Generator | Generate condensed references from docs | [quickref.tool.md](../.contextuate/tools/quickref.tool.md) |
-| Standards Detector | Analyze code to detect coding standards | [standards-detector.tool.md](../.contextuate/tools/standards-detector.tool.md) |
-| Agent Creator | Create new AI agent definitions | [agent-creator.tool.md](../.contextuate/tools/agent-creator.tool.md) |
+| Quickref Generator | Generate condensed references from docs | [quickref.md](../tools/quickref.md) |
+| Standards Detector | Analyze code to detect coding standards | [standards-detector.md](../tools/standards-detector.md) |
+| Agent Creator | Create new AI agent definitions | [agent-creator.md](../tools/agent-creator.md) |
 
 ### Framework Scripts (`docs/ai/.contextuate/bin/`)
 
@@ -47,7 +47,7 @@ Generates AI-friendly quick references from full documentation.
 
 **Type:** AI Tool Guide (not a script)
 
-**Guide Location:** `docs/ai/.contextuate/tools/quickref.tool.md`
+**Guide Location:** `docs/ai/.contextuate/tools/quickref.md`
 
 **How to use:**
 1. Read the tool guide
@@ -71,7 +71,7 @@ Analyzes project source files to detect and document coding standards.
 
 **Type:** AI Tool Guide (not a script)
 
-**Guide Location:** `docs/ai/.contextuate/tools/standards-detector.tool.md`
+**Guide Location:** `docs/ai/.contextuate/tools/standards-detector.md`
 
 **How to use:**
 1. Read the tool guide
@@ -99,7 +99,7 @@ Creates new AI agent definitions following framework standards.
 
 **Type:** AI Tool Guide (not a script)
 
-**Guide Location:** `docs/ai/.contextuate/tools/agent-creator.tool.md`
+**Guide Location:** `docs/ai/.contextuate/tools/agent-creator.md`
 
 **How to use:**
 1. Read the tool guide
@@ -234,7 +234,7 @@ chmod +x ./docs/ai/.contextuate/bin/*.sh
 
 To add a new AI tool guide:
 
-1. Create `docs/ai/.contextuate/tools/{name}.tool.md`
+1. Create `docs/ai/.contextuate/tools/{name}.md`
 2. Follow the structure:
    - When to use
    - Input requirements

package/dist/templates/standards/agent-roles.md

@@ -1,34 +1,81 @@
 # Agent Roles (Team Roster)
 
-Overview of the specialized agents available in this framework. Each agent has a dedicated definition file in `.contextuate/agents/` containing their specific responsibilities and context.
+> **Purpose:** Authoritative registry of all specialist agents. Reference this when deciding which agent to delegate to.
 
-## Core Team
+All agents have dedicated definition files in `docs/ai/agents/` containing their full responsibilities and context.
 
-### [Archon (Orchestrator)](../agents/archon.md)
-Project Manager & Technical Lead. Parses user requests and manages the creation of tasks.
+---
 
-### [Forge (Infrastructure)](../agents/forge.md)
-Cloud Architect. Handles Docker, Kubernetes, Secrets, and CI/CD pipelines.
+## Specialist Agents
 
-### [Chronos (Data)](../agents/chronos.md)
-DBA. Manages database schemas, migrations, and performance indexing.
+| Agent | Model | Domain | When to Delegate |
+|-------|-------|--------|------------------|
+| [**PYTHIA**](../../agents/pythia.md) | Opus | Planning/Research | Pre-implementation research, ideation, specification (use for complex/unfamiliar work requiring deep planning) |
+| [**ARCHON**](../../agents/archon.md) | Opus | Orchestration | Complex multi-agent tasks requiring coordination (sub-orchestration) |
+| [**AEGIS**](../../agents/aegis.md) | Sonnet | Quality/Review | Code review, best practices, quality assurance |
+| [**ATLAS**](../../agents/atlas.md) | Sonnet | Navigation | Codebase exploration, file search, pattern discovery |
+| [**CANVAS**](../../agents/canvas.md) | Sonnet | Frontend/UX | UI components, state management, theming, design systems |
+| [**CHRONICLE**](../../agents/chronicle.md) | Sonnet | Documentation | Comments, markdown, changelogs |
+| [**CHRONOS**](../../agents/chronos.md) | Sonnet | Data/State | Database administration, caching, state management, performance |
+| [**CIPHER**](../../agents/cipher.md) | Sonnet | Data Transformation | Data utilities, formatting, transformations |
+| [**CRUCIBLE**](../../agents/crucible.md) | Sonnet | Testing | Test writing, execution, coverage |
+| [**ECHO**](../../agents/echo.md) | Sonnet | Frontend JS | JavaScript, UI interactions, client-side |
+| [**FORGE**](../../agents/forge.md) | Sonnet | Infrastructure | Scaffolding, deployment, DevOps, tooling |
+| [**LEDGER**](../../agents/ledger.md) | Sonnet | Task Management | Multi-step tasks, session continuity, progress tracking |
+| [**MERIDIAN**](../../agents/meridian.md) | Sonnet | Schema/Migrations | Database schema changes, migrations |
+| [**NEXUS**](../../agents/nexus.md) | Sonnet | Backend/Services | Service classes, external APIs, business logic |
+| [**THOTH**](../../agents/thoth.md) | Opus | Database/Queries | Complex database queries, schema design, data operations |
+| [**SCRIBE**](../../agents/scribe.md) | Sonnet | Documentation | API docs, technical writing, user guides |
+| [**SENTINEL**](../../agents/sentinel.md) | Opus | Security | Validation, permissions, sanitization, security analysis |
+| [**UNITY**](../../agents/unity.md) | Sonnet | Version Control | Git merges, conflict resolution, release management |
+| [**VOX**](../../agents/vox.md) | Sonnet | Media/Communications | WebRTC, streaming, audio/video processing |
+| [**WEAVER**](../../agents/weaver.md) | Sonnet | Controllers/Views | Page actions, view rendering, permissions |
 
-### [Vox (Media)](../agents/vox.md)
-Communications Specialist. Handles WebRTC, SIP, and audio/video processing.
+---
 
-### [Ledger (Finance)](../agents/ledger.md)
-Billing Engineer. Manages invoicing, payments, and financial reporting.
+## Quick Reference by Task Type
 
-### [Nexus (Backend)](../agents/nexus.md)
-API Engineer. Implements business logic, REST/GraphQL APIs, and security.
+### Planning & Research
+- **PYTHIA** - Use BEFORE implementation for complex/unfamiliar work
 
-### [Canvas (Frontend)](../agents/canvas.md)
-UI/UX Engineer. Builds user interfaces, state management, and design systems.
+### Code Implementation
+- **NEXUS** - Backend services, APIs, business logic
+- **ECHO** - Frontend JavaScript, client-side
+- **CANVAS** - UI components, design systems
+- **WEAVER** - Controllers, views, page actions
+- **CIPHER** - Data transformations, utilities
 
-## Support Team
+### Data & Database
+- **THOTH** - Complex queries, schema design
+- **CHRONOS** - Database admin, caching, performance
+- **MERIDIAN** - Schema migrations
 
-### [Unity (Versioning)](../agents/unity.md)
-Git Specialist. Resolves merge conflicts and manages release branches.
+### Quality & Security
+- **AEGIS** - Code review, best practices
+- **CRUCIBLE** - Testing, coverage
+- **SENTINEL** - Security, validation, permissions
 
-### [Scribe (Docs)](../agents/scribe.md)
-Technical Writer. maintains documentation, logs, and long-term memory.
+### Infrastructure & Ops
+- **FORGE** - Scaffolding, DevOps, deployment
+- **UNITY** - Git, version control, releases
+
+### Documentation & Communication
+- **CHRONICLE** - Comments, changelogs
+- **SCRIBE** - API docs, technical writing
+- **VOX** - Media, WebRTC, streaming
+
+### Coordination
+- **ARCHON** - Multi-agent orchestration
+- **LEDGER** - Task tracking, progress management
+- **ATLAS** - Codebase navigation, exploration
+
+---
+
+## Delegation Guidelines
+
+1. **Check this roster** before delegating to ensure you pick the right specialist
+2. **Provide context** - Include relevant files, patterns, and constraints
+3. **Be specific** - Clear objectives get better results
+4. **Consider dependencies** - Some tasks need sequential agents (e.g., THOTH before NEXUS for data-heavy APIs)
+
+For full orchestration protocols, see [ARCHON](../../agents/archon.md).

package/dist/templates/standards/coding-standards.md

@@ -8,27 +8,17 @@
 
 When looking up coding standards for a specific language, follow this order:
 
-1. **User Standards (First Priority)**
-   Check `docs/ai/standards/{language}.standards.md`
+1. **Project Standards (First Priority)**
+   Look for `docs/ai/standards/{language}.standards.md` in the project
    - Example: `docs/ai/standards/php.standards.md`
-   - These are project-specific customizations
+   - These are project-specific customizations created by the user
 
-2. **Framework Standards (Fallback)**
-   Check `docs/ai/.context/templates/standards/{language}.standards.md`
-   - Example: `docs/ai/.context/templates/standards/php.standards.md`
-   - These are framework-provided defaults
-
-3. **General Principles (Always Apply)**
+2. **General Principles (Always Apply)**
    The general principles below always apply regardless of language.
 
-### Supported Framework Standards
-
-| Language | Template Location |
-|----------|-------------------|
-| PHP | `templates/standards/php.standards.md` |
-| JavaScript/TypeScript | `templates/standards/javascript.standards.md` |
+### Creating Language-Specific Standards
 
-*Use the [Standards Detector](../tools/standards-detector.tool.md) to generate project-specific standards.*
+Use the [Standards Detector](../tools/standards-detector.md) to analyze your codebase and generate project-specific standards automatically.
 
 ---
 
@@ -149,18 +139,11 @@ ORDER BY column_name;
 To customize standards for your project:
 
 1. **Run Standards Detector** (recommended)
-   Have AI analyze your codebase using the [Standards Detector](../tools/standards-detector.tool.md) tool.
+   Have AI analyze your codebase using the [Standards Detector](../tools/standards-detector.md) tool.
    This creates files in `docs/ai/standards/` based on your existing code.
 
-2. **Copy and Modify Template**
-   Copy a framework template to `docs/ai/standards/`:
-   ```bash
-   cp docs/ai/.context/templates/standards/php.standards.md docs/ai/standards/
-   ```
-   Then customize the placeholders.
-
-3. **Create from Scratch**
-   Create `docs/ai/standards/{language}.standards.md` with your own format.
+2. **Create from Scratch**
+   Create `docs/ai/standards/{language}.standards.md` with your own format following the patterns in this document.
 
 ### Common Customizations
 

package/dist/templates/templates/context.md

@@ -1,7 +1,22 @@
 # Project Context
 
-> **Purpose:** Master index for AI assistants working with this project. This is the primary entry point for all AI context.
-> **Directive:** Read this file first. It is the "Brain" of the project.
+> **Purpose:** User-defined project context for AI assistants. This file contains project-specific identity, tech stack, and custom configurations.
+> **Directive:** This file is linked from the framework entry point (`docs/ai/.contextuate/contextuate.md`). Edit this file freely to customize your project context.
+
+---
+
+## File Ownership
+
+| Path | Owner | Editable? |
+|------|-------|-----------|
+| `docs/ai/.contextuate/` | Framework (Contextuate) | No - overwritten on updates |
+| `docs/ai/context.md` | User (You) | Yes - customize freely |
+| `docs/ai/agents/` | User | Yes - your custom agents |
+| `docs/ai/standards/` | User | Yes - your custom standards |
+| `docs/ai/quickrefs/` | User | Yes - your generated quickrefs |
+| `docs/ai/tasks/` | User | Yes - your multi-session tasks |
+
+The `.contextuate/` folder contains immutable framework definitions that bootstrap AI context loading. The framework entry point (`contextuate.md`) links to this file for project-specific details.
 
 ---
 

package/dist/templates/templates/contextuate.md

@@ -2,11 +2,11 @@
 
 <!--
   CONTEXTUATE MANAGED FILE - DO NOT MODIFY
-  This file is generated by the Esotech Framework and will be overwritten during updates.
+  This file is generated by the Contextuate Framework and will be overwritten during updates.
   Customize your project context in: docs/ai/context.md
 -->
 
-> **Purpose:** Master entry point for AI assistants. This file bootstraps the Esotech Framework.
+> **Purpose:** Master entry point for AI assistants. This file bootstraps the Contextuate Framework.
 > **Directive:** Read this file first, then follow instructions to load project context.
 
 ---
@@ -29,7 +29,7 @@ This folder (`docs/ai/.contextuate/`) contains the immutable framework definitio
 2.  **Select**: Identify the specific agent, tool, or standard relevant to your current task.
 3.  **Load**: Read only that specific file.
 
-For example, if you need to create a new agent, read `docs/ai/.contextuate/tools/agent-creator.tool.md`. You do not need to read the entire standards library unless you are writing code that specifically requires it.
+For example, if you need to create a new agent, read `docs/ai/.contextuate/tools/agent-creator.md`. You do not need to read the entire standards library unless you are writing code that specifically requires it.
 
 ---
 
@@ -40,9 +40,9 @@ For example, if you need to create a new agent, read `docs/ai/.contextuate/tools
 ### Agent Registry
 | Task Domain    | Agent        | Context File                                                                             |
 | -------------- | ------------ | ---------------------------------------------------------------------------------------- |
-| General Coding | Base Agent   | [.contextuate/agents/base.md](.contextuate/agents/base.md)                               |
-| Documentation  | Docs Expert  | [.contextuate/agents/documentation-expert.md](.contextuate/agents/documentation-expert.md) |
-| Tools Expert   | Tools Expert | [.contextuate/agents/tools-expert.md](.contextuate/agents/tools-expert.md)               |
+| General Coding | Base Agent   | [agents/base.md](agents/base.md)                               |
+| Documentation  | Docs Expert  | [agents/documentation-expert.md](agents/documentation-expert.md) |
+| Tools Expert   | Tools Expert | [agents/tools-expert.md](agents/tools-expert.md)               |
 
 ### Custom Agents
 Custom agents are stored in `docs/ai/agents/`. Create new agents using the Agent Creator tool.
@@ -54,29 +54,25 @@ Custom agents are stored in `docs/ai/agents/`. Create new agents using the Agent
 ### Framework Tools
 | Tool                   | Purpose                       | Instruction Guide                                                                              |
 | ---------------------- | ----------------------------- | ---------------------------------------------------------------------------------------------- |
-| **Standards Detector** | Analyze code to find patterns | [.contextuate/tools/standards-detector.tool.md](.contextuate/tools/standards-detector.tool.md) |
-| **Quickref Generator** | Condense docs for AI usage    | [.contextuate/tools/quickref.tool.md](.contextuate/tools/quickref.tool.md)                     |
-| **Agent Creator**      | Generate new agent personas   | [.contextuate/tools/agent-creator.tool.md](.contextuate/tools/agent-creator.tool.md)           |
+| **Standards Detector** | Analyze code to find patterns | [tools/standards-detector.md](tools/standards-detector.md) |
+| **Quickref Generator** | Condense docs for AI usage    | [tools/quickref.md](tools/quickref.md)                     |
+| **Agent Creator**      | Generate new agent personas   | [tools/agent-creator.md](tools/agent-creator.md)           |
 
 ---
 
 ## 4. Standards & Conventions
 
-### Coding Standards
-| Language              | Standards File                                                                                                       |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| PHP                   | [.contextuate/templates/standards/php.standards.md](.contextuate/templates/standards/php.standards.md)               |
-| JavaScript/TypeScript | [.contextuate/templates/standards/javascript.standards.md](.contextuate/templates/standards/javascript.standards.md) |
-| Python                | [.contextuate/templates/standards/python.standards.md](.contextuate/templates/standards/python.standards.md)         |
-| Go                    | [.contextuate/templates/standards/go.standards.md](.contextuate/templates/standards/go.standards.md)                 |
-| Java                  | [.contextuate/templates/standards/java.standards.md](.contextuate/templates/standards/java.standards.md)             |
+### Framework Standards
+| Standard | Purpose | File |
+|----------|---------|------|
+| **Coding Standards** | General coding principles | [standards/coding-standards.md](standards/coding-standards.md) |
+| **Behavioral Guidelines** | AI interaction rules | [standards/behavioral-guidelines.md](standards/behavioral-guidelines.md) |
+| **Task Workflow** | Multi-session task structure | [standards/task-workflow.md](standards/task-workflow.md) |
+| **Agent Workflow** | Multi-agent coordination | [standards/agent-workflow.md](standards/agent-workflow.md) |
+| **Agent Roles** | Specialist agent roster | [standards/agent-roles.md](standards/agent-roles.md) |
 
-Custom standards can be added in `docs/ai/standards/`.
-
-### Behavioral Guidelines
-**[Behavioral Guidelines](.contextuate/standards/behavioral-guidelines.md)**
-- Verified Truth: Do not speculate.
-- Minimal Intervention: Only change what is requested.
+### Project-Specific Standards
+Create language-specific standards in `docs/ai/standards/` using the [Standards Detector](tools/standards-detector.md) tool.
 
 ---
 
@@ -94,16 +90,13 @@ Custom standards can be added in `docs/ai/standards/`.
 | **Custom Commands**     | `docs/ai/commands/`  |
 
 ### Multi-Session Tasks
-For complex tasks that span multiple sessions:
-1. Read **[Task Workflow](.contextuate/standards/task-workflow.md)**.
-2. Create a folder in `docs/ai/tasks/{task-name}/`.
-3. Maintain a `00-project-scope.md` and log files.
+For complex tasks that span multiple sessions, follow the Task Workflow standard (see section 4).
 
 ---
 
 ## 6. Framework Information
 
-**Esotech Framework** is a standardized AI context framework.
+**Contextuate Framework** is a standardized AI context framework.
 
 - **Documentation:** https://contextuate.md
 - **Version:** Check `.contextuate/version.json`

package/dist/templates/tools/{agent-creator.tool.md → agent-creator.md}

@@ -46,7 +46,7 @@ Before creating the agent, ensure documentation exists:
 | Comprehensive docs | `docs/{topic}.md` |
 | API/method reference | `docs/ai/quickrefs/{name}.quickref.md` |
 
-Use the [Quickref Generator](quickref.tool.md) if needed.
+Use the [Quickref Generator](quickref.md) if needed.
 
 ### Step 3: Create Agent File
 
@@ -78,7 +78,7 @@ Verify:
 ```markdown
 # {Name} Expert Agent
 
-> **Inherits:** [Base Agent Configuration](../.context/agents/base.md)
+> **Inherits:** [Base Agent Configuration](../.contextuate/agents/base.md)
 > **Role:** {One-line description of expertise}
 > **Domain:** `{file patterns covered}`
 
@@ -179,7 +179,7 @@ File: `docs/ai/agents/database-expert.md`
 ```markdown
 # Database Expert Agent
 
-> **Inherits:** [Base Agent Configuration](../.context/agents/base.md)
+> **Inherits:** [Base Agent Configuration](../.contextuate/agents/base.md)
 > **Role:** Expert in database operations, queries, and schema design
 > **Domain:** `*.sql`, `migrations/`, `**/db/**`