@ncoderz/awa 0.2.0 → 1.1.0

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>

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

@@ -1,61 +0,0 @@
-<schema target-files=".awa/specs/FEAT-{CODE}-{feature-name}.md">
-
-- Non-normative feature context. Explain what and why, not how.
-- Use clear, accessible language. Avoid jargon unless defined in glossary.
-- Required sections: problem, conceptual model, scenarios.
-- Optional sections: background, glossary, stakeholders, diagrams, non-normative notes.
-- Prohibited: normative language (SHALL/SHOULD/MAY), acceptance criteria, traceability IDs, design decisions.
-- Mark the document as INFORMATIVE (not normative).
-- Add metadata with change log.
-
-Example structure:
-
-```
-# Feature Context [INFORMATIVE]
-
-## Problem
-
-Why this feature exists. What pain point or gap it addresses.
-
-## Conceptual Model
-
-How users should think about this feature. Mental model, key abstractions.
-
-## Scenarios
-
-Concrete usage examples illustrating the feature in action.
-
-### Scenario 1: {title}
-{narrative}
-
-### Scenario 2: {title}
-{narrative}
-
-## Background
-
-Additional context: history, prior art, references.
-
-## Glossary
-
-- TERM: Definition
-
-## Stakeholders
-
-- ROLE: How they relate to this feature
-
-## Diagrams
-
-```mermaid
-{diagram}
-```
-
-## Non-Normative Notes
-
-Recommendations, best practices, or explanatory content that is not testable.
-
-## Change Log
-
-- {version} ({date}): {changes}
-```
-
-</schema>

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

@@ -1,8 +0,0 @@
-<schema target-files=".awa/plans/PLAN-{nnn}-{plan-name}.md">
-- Plan as already instructed, and:
-- Use as succinct language as possible
-- Add metadata:
-  - Status: "in-progress", "completed", "blocked"
-  - Workflow direction: "top-down", "bottom-up", "lateral"
-  - Traceability links to requirements/design/code/tests
-</schema>

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

@@ -1,133 +0,0 @@
-<schema target-file="README.md">
-
-```json
-{
-  "description": "Project README. Succinct language. User-facing. Link to detailed docs in /docs folder.",
-  "required": ["title", "description", "installation", "usage"],
-  "properties": {
-    "title": { "type": "project name" },
-    "badges": { "type": "array of badge markdown" },
-    "description": { "type": "one paragraph: what the project does and why" },
-    "features": { "type": "array of key features" },
-    "installation": {
-      "required": ["steps"],
-      "properties": {
-        "prerequisites": { "type": "array of requirements" },
-        "steps": { "type": "array of commands or instructions" }
-      }
-    },
-    "usage": {
-      "required": ["quickStart"],
-      "properties": {
-        "quickStart": { "type": "minimal example to get started" },
-        "examples": { "type": "array", "items": { "$ref": "#/$defs/example" } }
-      }
-    },
-    "documentation": { "type": "array of links to /docs files", "items": { "$ref": "#/$defs/docLink" } },
-    "contributing": { "type": "brief instructions or link to CONTRIBUTING.md" },
-    "license": { "type": "license name and link" },
-    "acknowledgments": { "type": "array of credits" }
-  },
-  "$defs": {
-    "example": {
-      "properties": {
-        "title": {},
-        "description": {},
-        "code": { "type": "code block" }
-      }
-    },
-    "docLink": {
-      "required": ["title", "path"],
-      "properties": {
-        "title": {},
-        "path": { "type": "relative path to /docs file" },
-        "description": {}
-      }
-    }
-  },
-  "$render": {
-    "template": "# {title}\\n\\n{badges?}\\n\\n{description}\\n\\n## Features\\n{features→'- {}'}\\n\\n## Installation\\n\\n### Prerequisites\\n{installation.prerequisites→'- {}'}\\n\\n### Install\\n{installation.steps→'```bash\\n{}\\n```'}\\n\\n## Usage\\n\\n{usage.quickStart}\\n\\n### Examples\\n{usage.examples→'#### {title}\\n{description?}\\n```\\n{CODE}\\n```'}\\n\\n## Documentation\\n{documentation→'- [{title}]({path}) — {description?}'}\\n\\n## Contributing\\n{contributing}\\n\\n## License\\n{license}\\n\\n## Acknowledgments\\n{acknowledgments→'- {}'}",
-    "omit": ["section if empty", "badges if absent", "Prerequisites if empty", "description in examples if absent", "Acknowledgments if empty"],
-    "prohibited": ["**bold** in section headers", "implementation details", "internal architecture", "excessive length — link to /docs instead"]
-  }
-}
-```
-
-<example>
-# awa CLI
-
-[![npm version](https://img.shields.io/npm/v/awa-cli.svg)](https://www.npmjs.com/package/awa-cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-
-awa CLI generates AI coding agent configuration files from templates, enabling developers to quickly scaffold consistent agent setups across projects.
-
-## Features
-
-- Template-based configuration generation
-- Feature flag support for conditional content
-- Multiple output formats (Markdown, YAML, JSON)
-- Diff mode to preview changes before applying
-- Local and remote template sources
-
-## Installation
-
-### Prerequisites
-
-- Node.js 20 or higher
-- npm or pnpm
-
-### Install
-
-```bash
-npm install -g awa-cli
-```
-
-## Usage
-
-```bash
-# Generate configuration from default template
-awa generate
-
-# Generate with specific features enabled
-awa generate --features typescript,testing
-
-# Preview changes without writing files
-awa diff
-```
-
-### Examples
-
-#### Custom Template
-
-```bash
-awa generate --template ./my-templates --output ./.ai
-```
-
-#### Feature Flags
-
-```bash
-awa generate --features strict,verbose --remove-features legacy
-```
-
-## Documentation
-
-- [Configuration Guide](docs/configuration.md) — Configure templates and options
-- [Template Authoring](docs/templates.md) — Create custom templates
-- [CLI Reference](docs/cli-reference.md) — Complete command documentation
-- [API Reference](docs/api.md) — Programmatic usage
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-## License
-
-[MIT](LICENSE)
-
-## Acknowledgments
-
-- Eta templating engine
-- Citty CLI framework
-</example>
-
-</schema>

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

@@ -1,125 +0,0 @@
-<schema target-files=".awa/specs/REQ-{CODE}-{feature-name}.md">
-
-```json
-{
-  "description": "Requirements only. Succinct language. Do not overspecify. Omit irrelevant information.",
-  "required": ["introduction", "requirements"],
-  "properties": {
-    "metadata": { "properties": { "changeLog": { "type": "array", "items": { "properties": { "version": {}, "date": {}, "changes": {} } } } } },
-    "introduction": { "type": "brief context for the requirements" },
-    "stakeholders": { "type": "array", "items": { "properties": { "role": {}, "description": {} } } },
-    "glossary": { "type": "object of term→definition" },
-    "requirements": { "type": "array", "items": { "$ref": "#/$defs/requirement" } },
-    "assumptions": { "type": "array of strings" },
-    "constraints": { "type": "array of strings" },
-    "outOfScope": { "type": "array of strings" }
-  },
-  "$defs": {
-    "requirement": {
-      "required": ["id", "title", "story", "criteria"],
-      "properties": {
-        "id": { "type": "pattern: {CODE}-{n} or {CODE}-{n}.{p} for subrequirements (e.g., CLI-3, ENG-1.1)" },
-        "title": { "type": "short title" },
-        "story": { "required": ["role", "want", "benefit"], "properties": { "role": {}, "want": {}, "benefit": {} } },
-        "criteria": { "type": "array", "items": { "$ref": "#/$defs/criterion" } },
-        "priority": { "enum": ["must", "should", "could", "wont"] },
-        "rationale": { "type": "why this requirement exists" },
-        "dependencies": { "type": "array of requirement IDs" },
-        "subrequirements": { "type": "array", "items": { "$ref": "#/$defs/requirement" } }
-      }
-    },
-    "criterion": {
-      "required": ["id", "type", "statement"],
-      "properties": {
-        "id": { "type": "pattern: {CODE}-{n}[.{p}]_AC-{m} for subrequirements (e.g., CLI-3_AC-1, ENG-1.1_AC-2)" },
-        "type": { "enum": ["ubiquitous", "event", "state", "conditional", "optional", "complex"] },
-        "statement": { "type": "testable statement using SHALL/SHOULD/MAY" },
-        "notes": { "type": "additional context" },
-        "testable": { "type": "boolean, default true" },
-        "verified": { "type": "boolean; true when validated as implemented and tested" }
-      }
-    }
-  },
-  "$render": {
-    "template": "# Requirements Specification\n\n## Introduction\n{introduction}\n\n## Glossary\n{glossary→'- {TERM}: {definition}'}\n\n## Stakeholders\n{stakeholders→'- {ROLE}: {description}'}\n\n## Requirements\n{requirements→'### {id}: {title} [{PRIORITY?}]\n\nAS A {story.role}, I WANT {story.want}, SO THAT {story.benefit}.\n\n> {rationale?}\n\nACCEPTANCE CRITERIA\n\n{criteria→\"- [{verified?x: }] {id} [{type}]: {statement} — {notes?} [untestable?]\"}\n\nDEPENDS ON: {dependencies?}'}\n\n## Assumptions\n{assumptions→'- {}'}\n\n## Constraints\n{constraints→'- {}'}\n\n## Out of Scope\n{outOfScope→'- {}'}\n\n## Change Log\n{metadata.changeLog→'- {version} ({date}): {changes}'}",
-    "omit": ["section if empty", "[PRIORITY] if absent", "rationale blockquote if absent", "— {notes} if absent", "[untestable] if testable true/absent", "DEPENDS ON if empty"],
-    "checkbox": "[x] if verified true, [ ] otherwise",
-    "prohibited": ["**bold** — use CAPITALS", "FieldName: value patterns", "nested bullets for story/criterion", "showing 'testable: true'", "headers for individual criteria"]
-  }
-}
-```
-
-<example>
-# Requirements Specification
-
-## Introduction
-
-Core engine requirements for game framework.
-
-## Glossary
-
-- GAME LOOP: Core cycle of update-render that drives the engine
-- CONTEXT: Runtime state container for engine subsystems
-
-## Stakeholders
-
-- GAME DEVELOPER: Builds games using the engine API
-- ENGINE MAINTAINER: Maintains and extends engine internals
-
-## Requirements
-
-### ENG-1: Core Engine Framework [MUST]
-
-AS A game developer, I WANT a game loop, SO THAT predictable execution.
-
-> Foundation for all games.
-
-ACCEPTANCE CRITERIA
-
-- [x] ENG-1_AC-1 [event]: WHEN engine initializes THEN system SHALL create context
-- [ ] ENG-1_AC-2 [event]: WHEN `--verbose` flag is provided THEN system SHALL enable debug logging — CLI flag
-- [ ] ENG-1_AC-3 [ubiquitous]: The system SHALL maintain 60fps minimum frame rate
-- [ ] ENG-1_AC-4 [event]: WHEN multiple `--preset` options are provided THEN system SHALL collect all values
-- [ ] ENG-1_AC-5 [conditional]: IF config contains a `[presets]` table THEN system SHALL parse it as a dictionary
-
-### ENG-1.1: Subsystem Registration [SHOULD]
-
-AS A engine maintainer, I WANT subsystems to self-register, SO THAT modular architecture.
-
-ACCEPTANCE CRITERIA
-
-- [ ] ENG-1.1_AC-1 [event]: WHEN subsystem loads THEN it SHALL register with context
-
-### ENG-2: Resource Management [MUST]
-
-AS A game developer, I WANT automatic resource loading, SO THAT simplified asset management.
-
-ACCEPTANCE CRITERIA
-
-- [ ] ENG-2_AC-1 [event]: WHEN resource requested THEN system SHALL load asynchronously
-- [ ] ENG-2_AC-2 [ubiquitous]: The system SHALL cache loaded resources
-
-DEPENDS ON: ENG-1
-
-## Assumptions
-
-- Target platform supports OpenGL 3.3 or higher
-- Config file uses TOML format with `[section]` syntax
-
-## Constraints
-
-- Must run on Windows, macOS, and Linux
-- CLI options like `--features` and `--remove-features` follow POSIX conventions
-
-## Out of Scope
-
-- Mobile platform support
-- Console platform support
-
-## Change Log
-
-- 1.0.0 (2025-01-10): Initial requirements
-- 1.1.0 (2025-01-15): Added `--preset` CLI option
-</example>
-
-</schema>