@ncoderz/awa 1.0.0 → 1.2.0

package/templates/awa/.awa/.agent/schemas/ALIGN_REPORT.schema.md

@@ -1,156 +0,0 @@
-<schema target-files=".awa/alignment/ALIGN-{x}-WITH-{y}-{nnn}.md">
-
-<definitions>
-  x = source artifact (what is being validated).
-  y = target artifact (what x is validated against).
-  <severity>
-    CRITICAL: MUST/SHALL violation, security, data integrity
-    MAJOR: SHOULD violation, UX, performance
-    MINOR: MAY not implemented, orphan traces, optional
-    INFO: superset additions, suggestions
-  </severity>
-  <confidence>
-    CERTAIN: explicit trace (IMPLEMENTS, VALIDATES, @awa-*)
-    LIKELY: naming convention or strong inference
-    UNCERTAIN: semantic inference only → flag for human review
-  </confidence>
-  <finding-type>
-    MISSING | DIFFERENCE | CONFLICT | INCOMPLETE | UNTESTED | ORPHAN | SUPERSET
-  </finding-type>
-  <trace_matrix>
-    <trace in="DESIGN component" marker="IMPLEMENTS: {CODE}-{n}[.{p}]_AC-{m}" to="REQ AC" />
-    <trace in="DESIGN property" marker="{CODE}_P-{n} VALIDATES: {CODE}-{n}[.{p}]_AC-{m} | {CODE}-{n}" to="REQ" />
-    <trace in="code" marker="@awa-component: {CODE}-{ComponentName}" to="DESIGN component" />
-    <trace in="code" marker="@awa-impl: {CODE}-{n}[.{p}]_AC-{m}" to="REQ AC" />
-    <trace in="tests" marker="@awa-test: {CODE}_P-{n}" to="DESIGN property" />
-    <trace in="tests" marker="@awa-test: {CODE}-{n}[.{p}]_AC-{m}" to="REQ AC" />
-    <infer target="semantic_traces" when="markers missing" confidence="LIKELY|UNCERTAIN" />
-  </trace_matrix>
-</definitions>
-
-```json
-{
-  "description": "Render as Markdown per $rendering.",
-  "type": "object",
-  "required": ["source", "target", "findings"],
-  "properties": {
-    "source": { "type": "string", "description": "x artifact path or identifier" },
-    "target": { "type": "string", "description": "y artifact path or identifier" },
-    "findings": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["severity", "confidence", "type", "sourceRef", "problem"],
-        "properties": {
-          "severity": { "enum": ["critical", "major", "minor", "info"] },
-          "confidence": { "enum": ["certain", "likely", "uncertain"] },
-          "type": { "enum": ["missing", "difference", "conflict", "incomplete", "superset", "orphan", "untested"] },
-          "sourceRef": {
-            "type": "object",
-            "required": ["location"],
-            "properties": {
-              "location": { "type": "string" },
-              "text": { "type": "string" }
-            }
-          },
-          "targetRef": {
-            "type": "object",
-            "properties": {
-              "location": { "type": "string" },
-              "text": { "type": "string" }
-            }
-          },
-          "problem": { "type": "string" },
-          "traceability": { "enum": ["explicit-implements", "explicit-validates", "explicit-awa-component", "explicit-awa-impl", "explicit-awa-test", "naming", "semantic"], "description": "How the trace was established" },
-          "resolution": { "type": "string" }
-        }
-      }
-    }
-  },
-  "$rendering": {
-    "templates": {
-      "withFindings": [
-        "# ALIGNMENT REPORT",
-        "{source} ↔ {target}",
-        "",
-        "{for each finding: templates.finding}",
-        "",
-        "## Summary",
-        "CRITICAL: {count}",
-        "MAJOR: {count}",
-        "MINOR: {count}",
-        "INFO: {count}",
-        "STATUS: {PASSED ✅ | FAILED ❌}"
-      ],
-      "noFindings": [
-        "# ALIGNMENT REPORT",
-        "{source} ↔ {target}",
-        "All checks passed. No alignment issues found.",
-        "**STATUS: PASSED ✅**"
-      ],
-      "finding": [
-        "- [ ] {n}. {SEVERITY} [{CONFIDENCE}] {TYPE}",
-        "",
-        "  SOURCE: {sourceRef.location}",
-        "  > {sourceRef.text}",
-        "",
-        "  TARGET: {targetRef.location}",
-        "  > {targetRef.text}",
-        "",
-        "  ISSUE: {problem}",
-        "",
-        "  RESOLUTION: {resolution}",
-        "",
-        "  *Traced via: {traceability}*"
-      ]
-    },
-    "statusRules": [
-      "FAILED if any CRITICAL or MAJOR findings",
-      "PASSED otherwise"
-    ],
-    "templateSelection": [
-      "No findings → noFindings",
-      "Findings exist → withFindings"
-    ],
-    "omissionRules": [
-      "Omit source blockquote if sourceRef.text absent",
-      "Omit TARGET: line entirely if targetRef absent → show 'TARGET: (not found)'",
-      "Omit target blockquote if targetRef.text absent",
-      "Omit *Traced via* if traceability starts with 'explicit-'",
-      "Omit RESOLUTION: if resolution absent"
-    ]
-  }
-}
-```
-
-<example>
-# ALIGNMENT REPORT
-
-DESIGN-WKS-workspace.md ↔ src/workspace/**
-
-- [ ] 1. CRITICAL [CERTAIN] MISSING
-  SOURCE: WKS-WorkspaceConfig (IMPLEMENTS: WKS-1_AC-1)
-  > pub fn load(root: &Path) -> Result<Self, WorkspaceError>
-  TARGET: (not found)
-  ISSUE: Design component declares IMPLEMENTS: WKS-1_AC-1, but no code file contains @awa-component: WKS-WorkspaceConfig with @awa-impl: WKS-1_AC-1.
-  RESOLUTION: Add @awa-component: WKS-WorkspaceConfig and @awa-impl: WKS-1_AC-1 to src/workspace/config.rs
-
-- [ ] 2. MAJOR [CERTAIN] DIFFERENCE
-  SOURCE: WKS-WorkspaceValidator (IMPLEMENTS: WKS-2_AC-3)
-  > fn validate(&self) -> Result<(), ValidationError>
-  TARGET: src/workspace/validator.rs:45
-  > fn validate(&self) -> bool
-  ISSUE: Return type mismatch. Design specifies Result<(), ValidationError> but implementation returns bool, losing error context.
-  RESOLUTION: Update validator.rs to return Result<(), ValidationError> as specified in design
-
-## Summary
-
-CRITICAL: 1
-MAJOR: 1
-MINOR: 0
-INFO: 0
-
-STATUS: FAILED ❌
-</example>
-
-</schema>

package/templates/awa/.awa/.agent/schemas/API.schema.md

@@ -1,4 +0,0 @@
-<schema target-files=".awa/specs/API-{api-name}.tsp">
-- You MUST write API specs in TypeSpec format unless requested otherwise.
-- If written in TypeSpec, API specifications follow TypeSpec format conventions.
-</schema>

package/templates/awa/.awa/.agent/schemas/ARCHITECTURE.schema.md

@@ -1,176 +0,0 @@
-<schema target-file=".awa/specs/ARCHITECTURE.md">
-- You MUST write API specs in TypeSpec format unless requested otherwise.
-- If written in TypeSpec, API specifications follow TypeSpec format conventions.
-
-```json
-{
-  "description": "Architecture only. Succinct language. Do not overspecify. Omit irrelevant information.",
-  "required": ["projectPurpose", "systemOverview", "technologyStack", "architectureDiagram", "directoryStructure", "componentDetails", "componentInteractions", "architecturalRules", "developerCommands"],
-  "properties": {
-    "projectPurpose": { "type": "single paragraph: core problem and primary functionality" },
-    "systemOverview": { "type": "array of software layers/subsystems" },
-    "technologyStack": { "type": "array", "items": { "properties": { "technology": { "type": "name with major version only" }, "purpose": {} } } },
-    "architectureDiagram": { "type": "mermaid diagram showing components, data flow, dependencies" },
-    "directoryStructure": { "type": "array", "items": { "properties": { "path": {}, "description": {} } } },
-    "componentDetails": { "type": "array", "items": { "$ref": "#/$defs/component" } },
-    "componentInteractions": {
-      "required": ["description"],
-      "properties": {
-        "description": {},
-        "diagrams": { "type": "array", "items": { "properties": { "title": {}, "mermaid": {} } } }
-      }
-    },
-    "architecturalRules": { "type": "array covering performance, scaling, maintainability, security, testing" },
-    "releaseStatus": { "type": "string: current release phase (e.g., Alpha, Beta, RC, GA) with brief description" },
-    "developerCommands": { "type": "array", "items": { "properties": { "command": {}, "description": {} } } },
-    "metadata": { "properties": { "changeLog": { "type": "array", "items": { "properties": { "version": {}, "date": {}, "changes": {} } } } } }
-  },
-  "$defs": {
-    "component": {
-      "required": ["name", "description", "responsibilities"],
-      "properties": {
-        "name": {},
-        "description": { "type": "single sentence" },
-        "responsibilities": { "type": "array of strings" },
-        "constraints": { "type": "array of strings" }
-      }
-    }
-  },
-  "$render": {
-    "template": "# Architecture\n\n## Project Purpose\n{projectPurpose}\n\n## System Overview\n{systemOverview→'- {}'}\n\n## Technology Stack\n{technologyStack→'- `{technology}` — {purpose}'}\n\n## High-Level Architecture\n```mermaid\n{architectureDiagram}\n```\n\n## Directory Structure\n```\n{directoryStructure→'{path}  # {description}'}\n```\n\n## Component Details\n{componentDetails→'### {name}\n\n{description}\n\nRESPONSIBILITIES\n{responsibilities→\"- {}\"}\n\nCONSTRAINTS\n{constraints?→\"- {}\"}'}\n\n## Component Interactions\n{componentInteractions.description}\n{componentInteractions.diagrams→'### {title}\n```mermaid\n{mermaid}\n```'}\n\n## Architectural Rules\n{architecturalRules→'- {}'}\n\n## Release Status\n{releaseStatus}\n\n## Developer Commands\n{developerCommands→'- `{command}` — {description}'}\n\n## Change Log\n{metadata.changeLog→'- {version} ({date}): {changes}'}",
-    "omit": ["CONSTRAINTS section if empty", "diagrams section if empty"],
-    "prohibited": ["**bold** — use CAPITALS", "minor versions in tech stack (major only)", "non-architecture directories", "detailed implementation in component descriptions"]
-  }
-}
-```
-
-<example>
-# Architecture
-
-## Project Purpose
-
-awa CLI generates AI coding agent configuration files from templates, enabling developers to quickly scaffold consistent agent setups across projects.
-
-## System Overview
-
-- CLI Layer
-- Core Engine
-- Template System
-- I/O Layer
-
-## Technology Stack
-
-- `Node.js 20` — Runtime environment
-- `TypeScript 5` — Type-safe development
-- `Eta 3` — Template rendering
-- `Citty` — CLI framework
-
-## High-Level Architecture
-
-```mermaid
-flowchart LR
-    subgraph Input
-        Args[CLI Args]
-        Config[.awa.toml]
-        Templates[Templates]
-    end
-    subgraph Core
-        Parser[ArgumentParser]
-        Engine[TemplateEngine]
-        Generator[FileGenerator]
-    end
-    subgraph Output
-        Files[Generated Files]
-    end
-    Args --> Parser
-    Config --> Parser
-    Parser --> Engine
-    Templates --> Engine
-    Engine --> Generator
-    Generator --> Files
-```
-
-## Directory Structure
-
-```
-src/           # Source code
-src/cli/       # CLI entry and commands
-src/core/      # Core engine logic
-src/utils/     # Shared utilities
-templates/     # Bundled templates
-```
-
-## Component Details
-
-### CLI Layer
-
-Handles argument parsing and command dispatch.
-
-RESPONSIBILITIES
-
-- Parse CLI arguments and options
-- Load and merge configuration
-- Dispatch to appropriate command handlers
-
-CONSTRAINTS
-
-- Must fail fast on invalid arguments
-- Must support --help and --version
-
-### Template Engine
-
-Renders templates with feature flag context.
-
-RESPONSIBILITIES
-
-- Load templates from local or remote sources
-- Render with Eta templating
-- Detect empty output for conditional file creation
-
-## Component Interactions
-
-The CLI parses arguments, loads configuration, then passes resolved options to the template engine which renders files through the generator.
-
-### Generate Command Flow
-
-```mermaid
-sequenceDiagram
-    participant User
-    participant CLI
-    participant Engine
-    participant Generator
-    User->>CLI: awa generate
-    CLI->>Engine: render(templates, features)
-    Engine->>Generator: write(files)
-    Generator-->>User: Success summary
-```
-
-## Architectural Rules
-
-- All file I/O must go through the I/O layer
-- Core engine must not depend on CLI layer
-- Templates must be stateless and deterministic
-- Errors must provide actionable messages with file paths
-- All public APIs must have TypeScript types
-
-## Release Status
-
-STATUS: Alpha
-
-Core functionality implemented. API may change without notice.
-
-## Developer Commands
-
-- `npm install` — Install dependencies
-- `npm run dev` — Run in development mode
-- `npm test` — Run test suite
-- `npm run lint` — Run linter
-- `npm run build` — Build for production
-
-## Change Log
-
-- 1.0.0 (2025-01-10): Initial architecture
-- 1.1.0 (2025-01-15): Added diff command
-</example>
-
-</schema>

package/templates/awa/.awa/.agent/schemas/DESIGN.schema.md

@@ -1,253 +0,0 @@
-<schema target-files=".awa/specs/DESIGN-{feature-name}.md">
-
-```json
-{
-  "description": "Design only. Succinct language. Do not overspecify. Omit irrelevant information.",
-  "required": ["overview", "architecture", "componentsAndInterfaces", "dataModels", "correctnessProperties", "errorHandling", "testingStrategy", "requirementsTraceability"],
-  "properties": {
-    "overview": { "type": "technical approach and rationale; reference REQ, do not restate" },
-    "architecture": {
-      "required": ["highLevelArchitecture", "moduleOrganization"],
-      "properties": {
-        "affectedLayers": { "type": "array of layer names" },
-        "highLevelArchitecture": { "properties": { "description": {}, "diagram": { "type": "mermaid" } } },
-        "moduleOrganization": { "properties": { "structure": { "type": "directory tree" }, "description": {} } },
-        "architecturalDecisions": { "type": "array", "items": { "$ref": "#/$defs/decision" } }
-      }
-    },
-    "componentsAndInterfaces": { "type": "array", "items": { "$ref": "#/$defs/component" } },
-    "dataModels": {
-      "required": ["coreTypes"],
-      "properties": {
-        "coreTypes": { "type": "array", "items": { "$ref": "#/$defs/dataType" } },
-        "entities": { "type": "array", "items": { "$ref": "#/$defs/entity" } }
-      }
-    },
-    "correctnessProperties": { "type": "array of formal invariants for property-based testing", "items": { "$ref": "#/$defs/property" } },
-    "errorHandling": {
-      "required": ["errorTypes", "strategy"],
-      "properties": {
-        "errorTypes": { "type": "array", "items": { "$ref": "#/$defs/errorType" } },
-        "strategy": { "properties": { "principles": { "type": "array of strings" } } }
-      }
-    },
-    "testingStrategy": {
-      "required": ["propertyBasedTesting"],
-      "properties": {
-        "propertyBasedTesting": {
-          "required": ["framework", "minimumIterations"],
-          "properties": {
-            "framework": {},
-            "minimumIterations": { "type": "integer" },
-            "tagFormat": {},
-            "exampleTests": { "type": "array", "items": { "properties": { "propertyId": {}, "code": {} } } }
-          }
-        },
-        "unitTesting": { "properties": { "description": {}, "areas": { "type": "array" } } },
-        "integrationTesting": { "properties": { "description": {}, "scenarios": { "type": "array" } } }
-      }
-    },
-    "requirementsTraceability": {
-      "required": ["source", "matrix"],
-      "properties": {
-        "source": { "type": "path to requirements file" },
-        "matrix": { "type": "array", "items": { "$ref": "#/$defs/traceEntry" } }
-      }
-    },
-    "libraryUsage": {
-      "properties": {
-        "frameworkFeatures": { "type": "array", "items": { "properties": { "feature": {}, "usage": {} } } },
-        "externalLibraries": { "type": "array", "items": { "properties": { "name": {}, "version": {}, "purpose": {} } } }
-      }
-    },
-    "metadata": { "properties": { "changeLog": { "type": "array", "items": { "properties": { "version": {}, "date": {}, "changes": {} } } } } }
-  },
-  "$defs": {
-    "decision": { "required": ["decision", "rationale"], "properties": { "decision": {}, "rationale": {}, "alternatives": { "type": "array" } } },
-    "component": {
-      "required": ["name", "description", "interface"],
-      "properties": {
-        "name": { "type": "pattern: {CODE}-{ComponentName} (e.g., CLI-Parser, CFG-ConfigLoader)" },
-        "description": { "type": "HOW it works, not WHAT (WHAT is in ACs)" },
-        "implements": { "type": "array of AC IDs (e.g., CFG-1_AC-1, CFG-1_AC-2)" },
-        "interface": { "type": "code block" }
-      }
-    },
-    "dataType": { "required": ["name"], "properties": { "name": {}, "description": {}, "definition": { "type": "code block" } } },
-    "entity": { "required": ["name", "fields"], "properties": { "name": {}, "description": {}, "fields": { "type": "array", "items": { "properties": { "name": {}, "type": {}, "required": {}, "description": {} } } } } },
-    "property": {
-      "required": ["id", "name", "description", "validates"],
-      "properties": {
-        "id": { "type": "pattern: {CODE}_P-{n} (e.g., CFG_P-1, GEN_P-2)" },
-        "name": {},
-        "description": {},
-        "validates": { "type": "array of AC or REQ IDs (e.g., CFG-4_AC-1, GEN-6)" }
-      }
-    },
-    "errorType": { "required": ["name", "variants"], "properties": { "name": {}, "description": {}, "variants": { "type": "array", "items": { "properties": { "name": {}, "description": {} } } } } },
-    "traceEntry": {
-      "required": ["criterionId", "componentName"],
-      "properties": {
-        "criterionId": { "type": "{CODE}-{n}[.{p}]_AC-{m}" },
-        "componentName": { "type": "{CODE}-{ComponentName}" },
-        "propertyId": { "type": "{CODE}_P-{n}" },
-        "status": { "enum": ["implemented", "partial", "deferred", "n/a"] },
-        "notes": {}
-      }
-    }
-  },
-  "$render": {
-    "template": "# Design Specification\n\n## Overview\n{overview}\n\n## Architecture\n\nAFFECTED LAYERS: {affectedLayers?}\n\n### High-Level Architecture\n{architecture.highLevelArchitecture.description}\n\n```mermaid\n{architecture.highLevelArchitecture.diagram}\n```\n\n### Module Organization\n```\n{architecture.moduleOrganization.structure}\n```\n\n### Architectural Decisions\n{architecturalDecisions→'- {DECISION}: {rationale}. Alternatives: {alternatives?}'}\n\n## Components and Interfaces\n{componentsAndInterfaces→'### {name}\n\n{description}\n\nIMPLEMENTS: {implements?}\n\n```typescript\n{interface}\n```'}\n\n## Data Models\n\n### Core Types\n{dataModels.coreTypes→'- {NAME}: {description}\n```typescript\n{definition}\n```'}\n\n### Entities\n{dataModels.entities→'### {name}\n{description}\n{fields→\"- {NAME} ({type}, {required?}): {description}\"}'}\n\n## Correctness Properties\n{correctnessProperties→'- {id} [{name}]: {description}\n  VALIDATES: {validates}'}\n\n## Error Handling\n{errorHandling.errorTypes→'### {name}\n{description}\n{variants→\"- {NAME}: {description}\"}'}\n\n### Strategy\nPRINCIPLES:\n{errorHandling.strategy.principles→'- {}'}\n\n## Testing Strategy\n\n### Property-Based Testing\n- FRAMEWORK: {testingStrategy.propertyBasedTesting.framework}\n- MINIMUM_ITERATIONS: {testingStrategy.propertyBasedTesting.minimumIterations}\n- TAG_FORMAT: {testingStrategy.propertyBasedTesting.tagFormat?}\n{testingStrategy.propertyBasedTesting.exampleTests→'```typescript\n// @awa-test: {propertyId}\n{CODE}\n```'}\n\n### Unit Testing\n{testingStrategy.unitTesting.description?}\n- AREAS: {testingStrategy.unitTesting.areas?}\n\n### Integration Testing\n{testingStrategy.integrationTesting.description?}\n- SCENARIOS: {testingStrategy.integrationTesting.scenarios?}\n\n## Requirements Traceability\nSOURCE: {requirementsTraceability.source}\n{requirementsTraceability.matrix→'- {criterionId} → {componentName} ({propertyId?}) [{status?|omit if implemented}] {notes?}'}\n\n## Library Usage\n\n### Framework Features\n{libraryUsage.frameworkFeatures→'- {FEATURE}: {usage}'}\n\n### External Libraries\n{libraryUsage.externalLibraries→'- {name} ({version}): {purpose}'}\n\n## Change Log\n{metadata.changeLog→'- {version} ({date}): {changes}'}",
-    "omit": ["section if empty", "AFFECTED LAYERS if absent", "IMPLEMENTS if empty", "(propertyId) if absent", "[status] if implemented", "notes/alternatives if empty"],
-    "prohibited": ["**bold** — use CAPITALS", "*italic*", "tables — use lists", "ASCII diagrams — use mermaid", "FieldName: value patterns", "restating WHAT (requirements) — describe HOW (design)"]
-  }
-}
-```
-
-<example>
-# Design Specification
-
-## Overview
-
-This design implements a CLI pipeline architecture for template-based code generation. The pipeline flows through argument parsing, configuration loading, template resolution, rendering, and file output with conflict resolution.
-
-## Architecture
-
-AFFECTED LAYERS: CLI Layer, Core Engine, I/O Layer
-
-### High-Level Architecture
-
-Sequential pipeline for predictable flow and error handling.
-
-```mermaid
-flowchart LR
-    Args[CLI Args] --> Parser
-    Config[.awa.toml] --> ConfigLoader
-    Parser --> ConfigLoader
-    ConfigLoader --> Engine[TemplateEngine]
-    Engine --> Generator[FileGenerator]
-    Generator --> Files[Output]
-```
-
-### Module Organization
-
-```
-src/
-├── cli/
-│   └── index.ts
-├── core/
-│   ├── config.ts
-│   ├── template.ts
-│   └── generator.ts
-└── utils/
-    └── fs.ts
-```
-
-### Architectural Decisions
-
-- PIPELINE OVER EVENT: Sequential pipeline for predictable flow and error handling. Alternatives: event-driven, middleware chain
-
-## Components and Interfaces
-
-### CFG-ConfigLoader
-
-Loads TOML configuration from file, merges with CLI arguments (CLI wins), and produces resolved options with defaults applied.
-
-IMPLEMENTS: CFG-1_AC-1, CFG-1_AC-2, CFG-4_AC-1
-
-```typescript
-interface ConfigLoader {
-  load(configPath: string | null): Promise<FileConfig | null>;
-  merge(cli: RawCliOptions, file: FileConfig | null): ResolvedOptions;
-}
-```
-
-## Data Models
-
-### Core Types
-
-- RESOLVED_OPTIONS: Fully resolved configuration with all defaults applied
-
-```typescript
-interface ResolvedOptions {
-  readonly output: string;
-  readonly template: string | null;
-  readonly features: readonly string[];
-  readonly force: boolean;
-}
-```
-
-## Correctness Properties
-
-- CFG_P-1 [CLI Override]: CLI arguments always override config file values for the same option
-  VALIDATES: CFG-4_AC-1, CFG-4_AC-2
-
-- GEN_P-2 [Dry Run Immutable]: Dry-run mode never modifies the file system
-  VALIDATES: GEN-6_AC-1, GEN-6_AC-2
-
-## Error Handling
-
-### ConfigError
-
-Configuration loading and parsing errors
-
-- FILE_NOT_FOUND: Config file does not exist when --config provided
-- PARSE_ERROR: TOML syntax error with line number
-
-### Strategy
-
-PRINCIPLES:
-
-- Fail fast on first error
-- Provide actionable error messages with file paths
-- Exit with non-zero code on any error
-
-## Testing Strategy
-
-### Property-Based Testing
-
-- FRAMEWORK: fast-check
-- MINIMUM_ITERATIONS: 100
-- TAG_FORMAT: @awa-test: {CODE}_P-{n}
-
-```typescript
-// @awa-test: CFG_P-1
-test.prop([fc.string(), fc.string()])('CLI overrides config', (cliValue, configValue) => {
-  const cli = { output: cliValue };
-  const config = { output: configValue };
-  const result = configLoader.merge(cli, config);
-  expect(result.output).toBe(cliValue);
-});
-```
-
-### Unit Testing
-
-Test individual components in isolation
-
-- AREAS: CFG-ConfigLoader merge logic, TPL-TemplateResolver type detection
-
-## Requirements Traceability
-
-SOURCE: .awa/specs/REQ-CLI.md, .awa/specs/REQ-CFG.md
-
-- CFG-1_AC-1 → CFG-ConfigLoader (CFG_P-1)
-- CFG-4_AC-1 → CFG-ConfigLoader (CFG_P-1)
-- GEN-6_AC-1 → GEN-FileGenerator (GEN_P-2) [partial] pending review
-
-## Library Usage
-
-### Framework Features
-
-- CITTY: Command definition, argument parsing, help generation
-
-### External Libraries
-
-- citty (latest): CLI framework
-- smol-toml (1.x): TOML parser
-
-## Change Log
-
-- 1.0.0 (2025-01-10): Initial design
-</example>
-
-</schema>

package/templates/awa/.awa/.agent/schemas/EXAMPLES.schema.md

@@ -1,51 +0,0 @@
-<schema target-files=".awa/specs/EXAMPLES-{CODE}-{feature-name}-{nnn}.md">
-
-- Concrete usage examples for a feature. Detailed, hands-on, reproducible.
-- Use the same {CODE} as the corresponding FEAT/REQ for the feature.
-- Number files sequentially (-001, -002, ...) when splitting at the 500-line limit.
-- Each example must have a title and context explaining what it demonstrates.
-- Required: at least one example with title, context, and code/demonstration block.
-- Optional: prerequisites, expected output, notes.
-- Prohibited: normative language (SHALL/SHOULD/MAY), acceptance criteria, traceability IDs, design decisions.
-- Mark the document as INFORMATIVE (not normative).
-
-Example structure:
-
-```
-# Usage Examples: {Feature Name} [INFORMATIVE]
-
-## Prerequisites
-
-- Required tools, setup, or prior knowledge
-
-## Example 1: {Title}
-
-{Context — when to use this, what it demonstrates}
-
-```bash
-{CLI invocation or code}
-```
-
-EXPECTED OUTPUT:
-
-```
-{expected result}
-```
-
-## Example 2: {Title}
-
-{Context}
-
-```typescript
-{code example}
-```
-
-NOTES:
-- Additional observations or caveats
-
-## Change Log
-
-- {version} ({date}): {changes}
-```
-
-</schema>