@ncoderz/awa 0.2.0 → 1.1.0

package/templates/awa/.cursor/rules/awa-agent.md

@@ -9,6 +9,6 @@ alwaysApply: true
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.cursor/rules/awa-align.md

@@ -0,0 +1,8 @@
+<% if (it.features.includes('cursor')) { %>
+---
+description: Align of source with target
+alwaysApply: false
+---
+
+<%~ include('_partials/awa.align.md', it) %>
+<% } %>

package/templates/awa/.cursor/rules/awa-check.md

@@ -0,0 +1,9 @@
+<% if (it.features.includes('cursor')) { %>
+---
+description: Run traceability and schema checks, then fix any errors
+alwaysApply: false
+---
+
+<%~ include('_partials/awa.check.md', it) %>
+<% } %>
+

package/templates/awa/.gemini/commands/awa-align.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('gemini')) { %>
+<%~ include('_partials/_cmd.awa-align.md', it) %>
+<% } %>

package/templates/awa/.gemini/commands/awa-check.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('gemini')) { %>
+<%~ include('_partials/_cmd.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.gemini/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('gemini')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.gemini/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('gemini')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.github/agents/awa.agent.md

@@ -1,6 +1,6 @@
 <% if (it.features.includes('copilot')) { %>
 ---
-description: "awa 0.2.0"
+description: "awa <%= it.version %>"
 tools: ['edit', 'search', 'runCommands', 'runTasks', 'microsoft/playwright-mcp/*', 'usages', 'vscodeAPI', 'problems', 'changes', 'testFailure', 'openSimpleBrowser', 'fetch', 'githubRepo', 'extensions', 'todos', 'runTests']
 ---
 
@@ -9,6 +9,6 @@ tools: ['edit', 'search', 'runCommands', 'runTasks', 'microsoft/playwright-mcp/*
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.github/prompts/awa.align.prompt.md

@@ -0,0 +1,8 @@
+<% if (it.features.includes('copilot')) { %>
+---
+description: Align of source with target (check source matches target, and if not list differences)
+argument-hint: "<source> [<target>]"
+---
+
+<%~ include('_partials/awa.align.md', it) %>
+<% } %>

package/templates/awa/.github/prompts/awa.check.prompt.md

@@ -0,0 +1,9 @@
+<% if (it.features.includes('copilot')) { %>
+---
+description: Run traceability and schema checks, then fix any errors
+argument-hint: "[<instructions>]"
+---
+
+<%~ include('_partials/awa.check.md', it) %>
+<% } %>
+

package/templates/awa/.github/skills/awa-align/SKILL.md

@@ -0,0 +1,8 @@
+<% if (it.features.includes('copilot')) { %>
+---
+name: awa-align
+description: Align of source with target. Use this when asked to validate, check, or verify alignment between artifacts.
+---
+
+<%~ include('_partials/awa.align.md', it) %>
+<% } %>

package/templates/awa/.github/skills/awa-check/SKILL.md

@@ -0,0 +1,9 @@
+<% if (it.features.includes('copilot')) { %>
+---
+name: awa-check
+description: Run traceability and schema checks, then fix any errors. Use this when asked to check, validate, or fix traceability and schema issues.
+---
+
+<%~ include('_partials/awa.check.md', it) %>
+<% } %>
+

package/templates/awa/.kilocode/rules/awa-agent.md

@@ -8,6 +8,6 @@ description: awa AI coding assistant — core system instructions
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.kilocode/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('kilocode')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.kilocode/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('kilocode')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.kilocode/workflows/awa-align.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('kilocode')) { %>
+<%~ include('_partials/_cmd.awa-align.md', it) %>
+<% } %>

package/templates/awa/.kilocode/workflows/awa-check.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('kilocode')) { %>
+<%~ include('_partials/_cmd.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.opencode/agents/awa.md

@@ -1,7 +1,7 @@
 <% if (it.features.includes('opencode')) { %>
 ---
 name: awa
-description: "awa 0.2.0"
+description: "awa <%= it.version %>"
 ---
 
 <%~ include('_partials/awa.core.md', it) %>
@@ -9,6 +9,6 @@ description: "awa 0.2.0"
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.opencode/commands/awa-align.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('opencode')) { %>
+<%~ include('_partials/_cmd.awa-align.md', it) %>
+<% } %>

package/templates/awa/.opencode/commands/awa-check.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('opencode')) { %>
+<%~ include('_partials/_cmd.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.opencode/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('opencode')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.opencode/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('opencode')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.qwen/commands/awa-align.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('qwen')) { %>
+<%~ include('_partials/_cmd.awa-align.md', it) %>
+<% } %>

package/templates/awa/.qwen/commands/awa-check.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('qwen')) { %>
+<%~ include('_partials/_cmd.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.qwen/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('qwen')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.qwen/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('qwen')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.roo/rules/awa-agent.md

@@ -8,6 +8,6 @@ description: awa AI coding assistant — core system instructions
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.roo/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('roo')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.roo/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('roo')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/.windsurf/rules/awa-agent.md

@@ -9,6 +9,6 @@ trigger: always_on
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/.windsurf/skills/awa-align/SKILL.md

@@ -0,0 +1,3 @@
+<% if (it.features.includes('windsurf')) { %>
+<%~ include('_partials/_skill.awa-align.md', it) %>
+<% } %>

package/templates/awa/.windsurf/skills/awa-check/SKILL.md

@@ -0,0 +1,4 @@
+<% if (it.features.includes('windsurf')) { %>
+<%~ include('_partials/_skill.awa-check.md', it) %>
+<% } %>
+

package/templates/awa/AGENTS.md

@@ -4,6 +4,6 @@
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/CLAUDE.md

@@ -4,6 +4,6 @@
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/GEMINI.md

@@ -4,6 +4,6 @@
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/QWEN.md

@@ -4,6 +4,6 @@
 <tool name="read_file">
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" />
- <read path=".awa/.agent/schemas/*.schema.md" required="before writing corresponding file type" />
+ <read path=".awa/.agent/schemas/*.schema.yaml" required="before writing corresponding file type" />
 </tool>
 <% } %>

package/templates/awa/_README.md

@@ -39,12 +39,13 @@ npx awa generate . --template ./templates/awa --features agents-md
 
 ## Generated Skills
 
-Each tool that supports Agent Skills receives the full set of 14 awa skills:
+Each tool that supports Agent Skills receives the full set of 15 awa skills:
 
 | Skill | Description |
 |-------|-------------|
 | `awa-architecture` | Create or update ARCHITECTURE.md |
 | `awa-brainstorm` | Brainstorm ideas, explore solutions |
+| `awa-check` | Run traceability and schema checks, then fix errors |
 | `awa-code` | Implement code and tests |
 | `awa-design` | Create or update design documents |
 | `awa-documentation` | Create or update project documentation |
@@ -55,7 +56,7 @@ Each tool that supports Agent Skills receives the full set of 14 awa skills:
 | `awa-requirements` | Create or update requirements documents |
 | `awa-tasks` | Create or update task list documents |
 | `awa-upgrade` | Upgrade specs to match current schemas |
-| `awa-validate-alignment` | Validate alignment between artifacts |
+| `awa-align` | Validate alignment between artifacts |
 | `awa-vibe` | Full awa workflow from idea to completion |
 
 ## Partials

package/templates/awa/_delete.txt

@@ -12,6 +12,18 @@
 .github/agents/awa-requirements.agent.md
 .github/agents/awa-vibe.agent.md
 
+# Schema files replaced by .schema.yaml
+.awa/.agent/schemas/ARCHITECTURE.schema.md
+.awa/.agent/schemas/ALIGN_REPORT.schema.md
+.awa/.agent/schemas/API.schema.md
+.awa/.agent/schemas/DESIGN.schema.md
+.awa/.agent/schemas/EXAMPLES.schema.md
+.awa/.agent/schemas/FEAT.schema.md
+.awa/.agent/schemas/PLAN.schema.md
+.awa/.agent/schemas/README.schema.md
+.awa/.agent/schemas/REQ.schema.md
+.awa/.agent/schemas/TASK.schema.md
+
 # @feature copilot
 .github/agents/awa.agent.md
 .github/prompts/awa.architecture.prompt.md
@@ -26,6 +38,8 @@
 .github/prompts/awa.requirements.prompt.md
 .github/prompts/awa.tasks.prompt.md
 .github/prompts/awa.upgrade.prompt.md
+.github/prompts/awa.align.prompt.md
+.github/prompts/awa.check.prompt.md
 .github/prompts/awa.validate-alignment.prompt.md
 .github/prompts/awa.vibe.prompt.md
 .github/skills/awa-architecture/SKILL.md
@@ -40,6 +54,8 @@
 .github/skills/awa-requirements/SKILL.md
 .github/skills/awa-tasks/SKILL.md
 .github/skills/awa-upgrade/SKILL.md
+.github/skills/awa-align/SKILL.md
+.github/skills/awa-check/SKILL.md
 .github/skills/awa-validate-alignment/SKILL.md
 .github/skills/awa-vibe/SKILL.md
 
@@ -58,6 +74,8 @@ CLAUDE.md
 .claude/skills/awa-requirements/SKILL.md
 .claude/skills/awa-tasks/SKILL.md
 .claude/skills/awa-upgrade/SKILL.md
+.claude/skills/awa-align/SKILL.md
+.claude/skills/awa-check/SKILL.md
 .claude/skills/awa-validate-alignment/SKILL.md
 .claude/skills/awa-vibe/SKILL.md
 
@@ -75,6 +93,8 @@ CLAUDE.md
 .cursor/rules/awa-requirements.md
 .cursor/rules/awa-tasks.md
 .cursor/rules/awa-upgrade.md
+.cursor/rules/awa-align.md
+.cursor/rules/awa-check.md
 .cursor/rules/awa-validate-alignment.md
 .cursor/rules/awa-vibe.md
 
@@ -92,6 +112,8 @@ CLAUDE.md
 .windsurf/skills/awa-requirements/SKILL.md
 .windsurf/skills/awa-tasks/SKILL.md
 .windsurf/skills/awa-upgrade/SKILL.md
+.windsurf/skills/awa-align/SKILL.md
+.windsurf/skills/awa-check/SKILL.md
 .windsurf/skills/awa-validate-alignment/SKILL.md
 .windsurf/skills/awa-vibe/SKILL.md
 
@@ -109,6 +131,8 @@ CLAUDE.md
 .kilocode/workflows/awa-requirements.md
 .kilocode/workflows/awa-tasks.md
 .kilocode/workflows/awa-upgrade.md
+.kilocode/workflows/awa-align.md
+.kilocode/workflows/awa-check.md
 .kilocode/workflows/awa-validate-alignment.md
 .kilocode/workflows/awa-vibe.md
 .kilocode/skills/awa-architecture/SKILL.md
@@ -123,6 +147,8 @@ CLAUDE.md
 .kilocode/skills/awa-requirements/SKILL.md
 .kilocode/skills/awa-tasks/SKILL.md
 .kilocode/skills/awa-upgrade/SKILL.md
+.kilocode/skills/awa-align/SKILL.md
+.kilocode/skills/awa-check/SKILL.md
 .kilocode/skills/awa-validate-alignment/SKILL.md
 .kilocode/skills/awa-vibe/SKILL.md
 
@@ -140,6 +166,8 @@ CLAUDE.md
 .opencode/commands/awa-requirements.md
 .opencode/commands/awa-tasks.md
 .opencode/commands/awa-upgrade.md
+.opencode/commands/awa-align.md
+.opencode/commands/awa-check.md
 .opencode/commands/awa-validate-alignment.md
 .opencode/commands/awa-vibe.md
 .opencode/skills/awa-architecture/SKILL.md
@@ -154,6 +182,8 @@ CLAUDE.md
 .opencode/skills/awa-requirements/SKILL.md
 .opencode/skills/awa-tasks/SKILL.md
 .opencode/skills/awa-upgrade/SKILL.md
+.opencode/skills/awa-align/SKILL.md
+.opencode/skills/awa-check/SKILL.md
 .opencode/skills/awa-validate-alignment/SKILL.md
 .opencode/skills/awa-vibe/SKILL.md
 
@@ -174,6 +204,8 @@ GEMINI.md
 .gemini/commands/awa-requirements.md
 .gemini/commands/awa-tasks.md
 .gemini/commands/awa-upgrade.md
+.gemini/commands/awa-align.md
+.gemini/commands/awa-check.md
 .gemini/commands/awa-validate-alignment.md
 .gemini/commands/awa-vibe.md
 .gemini/skills/awa-architecture/SKILL.md
@@ -188,6 +220,8 @@ GEMINI.md
 .gemini/skills/awa-requirements/SKILL.md
 .gemini/skills/awa-tasks/SKILL.md
 .gemini/skills/awa-upgrade/SKILL.md
+.gemini/skills/awa-align/SKILL.md
+.gemini/skills/awa-check/SKILL.md
 .gemini/skills/awa-validate-alignment/SKILL.md
 .gemini/skills/awa-vibe/SKILL.md
 
@@ -205,6 +239,8 @@ QWEN.md
 .qwen/commands/awa-requirements.md
 .qwen/commands/awa-tasks.md
 .qwen/commands/awa-upgrade.md
+.qwen/commands/awa-align.md
+.qwen/commands/awa-check.md
 .qwen/commands/awa-validate-alignment.md
 .qwen/commands/awa-vibe.md
 .qwen/skills/awa-architecture/SKILL.md
@@ -219,6 +255,8 @@ QWEN.md
 .qwen/skills/awa-requirements/SKILL.md
 .qwen/skills/awa-tasks/SKILL.md
 .qwen/skills/awa-upgrade/SKILL.md
+.qwen/skills/awa-align/SKILL.md
+.qwen/skills/awa-check/SKILL.md
 .qwen/skills/awa-validate-alignment/SKILL.md
 .qwen/skills/awa-vibe/SKILL.md
 
@@ -236,6 +274,8 @@ QWEN.md
 .roo/skills/awa-requirements/SKILL.md
 .roo/skills/awa-tasks/SKILL.md
 .roo/skills/awa-upgrade/SKILL.md
+.roo/skills/awa-align/SKILL.md
+.roo/skills/awa-check/SKILL.md
 .roo/skills/awa-validate-alignment/SKILL.md
 .roo/skills/awa-vibe/SKILL.md
 
@@ -252,6 +292,8 @@ QWEN.md
 .codex/prompts/awa-requirements.md
 .codex/prompts/awa-tasks.md
 .codex/prompts/awa-upgrade.md
+.codex/prompts/awa-align.md
+.codex/prompts/awa-check.md
 .codex/prompts/awa-validate-alignment.md
 .codex/prompts/awa-vibe.md
 .agents/skills/awa-architecture/SKILL.md
@@ -266,6 +308,8 @@ QWEN.md
 .agents/skills/awa-requirements/SKILL.md
 .agents/skills/awa-tasks/SKILL.md
 .agents/skills/awa-upgrade/SKILL.md
+.agents/skills/awa-align/SKILL.md
+.agents/skills/awa-check/SKILL.md
 .agents/skills/awa-validate-alignment/SKILL.md
 .agents/skills/awa-vibe/SKILL.md
 
@@ -282,6 +326,8 @@ QWEN.md
 .agent/workflows/awa-requirements.md
 .agent/workflows/awa-tasks.md
 .agent/workflows/awa-upgrade.md
+.agent/workflows/awa-align.md
+.agent/workflows/awa-check.md
 .agent/workflows/awa-validate-alignment.md
 .agent/workflows/awa-vibe.md
 .agent/skills/awa-architecture/SKILL.md
@@ -296,5 +342,8 @@ QWEN.md
 .agent/skills/awa-requirements/SKILL.md
 .agent/skills/awa-tasks/SKILL.md
 .agent/skills/awa-upgrade/SKILL.md
+.agent/skills/awa-align/SKILL.md
+.agent/skills/awa-check/SKILL.md
 .agent/skills/awa-validate-alignment/SKILL.md
 .agent/skills/awa-vibe/SKILL.md
+

package/templates/awa/_partials/{_cmd.awa-validate-alignment.md → _cmd.awa-align.md}

@@ -3,4 +3,4 @@ description: Validate alignment of source with target
 argument-hint: "<source> <target> [<instructions>]"
 ---
 
-<%~ include('awa.validate-alignment.md', it) %>
+<%~ include('awa.align.md', it) %>

package/templates/awa/_partials/_cmd.awa-check.md

@@ -0,0 +1,6 @@
+---
+description: Run traceability and schema checks, then fix any errors
+argument-hint: "[<instructions>]"
+---
+
+<%~ include('awa.check.md', it) %>

package/templates/awa/_partials/_skill.awa-align.md

@@ -0,0 +1,6 @@
+---
+name: awa-align
+description: Align source with target. Use this when asked to align, check, or verify alignment between artifacts.
+---
+
+<%~ include('awa.align.md', it) %>

package/templates/awa/_partials/_skill.awa-check.md

@@ -0,0 +1,6 @@
+---
+name: awa-check
+description: Run traceability and schema checks, then fix any errors. Use this when asked to check, validate, or fix traceability and schema issues.
+---
+
+<%~ include('awa.check.md', it) %>

package/templates/awa/_partials/{awa.validate-alignment.md → awa.align.md}

@@ -1,4 +1,4 @@
-# Validate alignment of Source(x) with Target(y)
+# Validate Alignment of Source(x) with Target(y)
 
 ## Bootstrap
 
@@ -6,7 +6,7 @@
  <read path=".awa/.agent/awa.core.md" required="true" error="on not found" />
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="true" error="on not found" />
- <read path=".awa/.agent/schemas/ALIGN_REPORT.schema.md" required="true" error="on not found" />
+ <read path=".awa/.agent/schemas/ALIGN_REPORT.schema.yaml" required="true" error="on not found" />
 </tool>
 
 ## User Input

package/templates/awa/_partials/awa.architecture.md

@@ -6,7 +6,7 @@
  <read path=".awa/.agent/awa.core.md" required="true" error="on not found" />
  <read path=".awa/rules/*.md" required="true" />
  <read path=".awa/specs/ARCHITECTURE.md" required="if exists" />
- <read path=".awa/.agent/schemas/ARCHITECTURE.schema.md" required="true" error="on not found" />
+ <read path=".awa/.agent/schemas/ARCHITECTURE.schema.yaml" required="true" error="on not found" />
 </tool>
 
 ## User Input

package/templates/awa/_partials/awa.check.md

@@ -0,0 +1,73 @@
+# Run Traceability and Schema Checks
+
+## Bootstrap
+
+<tool name="read_file">
+ <read path=".awa/.agent/awa.core.md" required="true" error="on not found" />
+ <read path=".awa/rules/*.md" required="true" />
+ <read path=".awa/specs/ARCHITECTURE.md" required="true" error="on not found" />
+</tool>
+
+## User Input
+
+```text
+${input}
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Inputs
+
+<file type="architecture" path=".awa/specs/ARCHITECTURE.md" />
+<file type="requirements" path=".awa/specs/REQ-{CODE}-{feature-name}.md" required="if relevant" />
+<file type="design" path=".awa/specs/DESIGN-{CODE}-{feature-name}.md" required="if relevant" />
+<file type="code_and_tests" path="various" required="if relevant" />
+
+## Action
+
+Run `awa check` to validate traceability integrity and schema correctness across the project, then analyze and fix any reported errors.
+
+## Process
+
+1. RUN CHECK
+   - Execute `awa check` using the project's package manager
+   - Capture the full output (errors and warnings)
+
+2. ANALYZE FINDINGS
+   - Parse the output for errors (exit code 1) and warnings
+   - Group findings by type:
+     - **Orphaned markers**: `@awa-impl`, `@awa-test`, or `@awa-component` referencing IDs not found in specs
+     - **Broken cross-references**: IMPLEMENTS/VALIDATES pointing to invalid targets
+     - **Schema violations**: Missing sections, wrong heading levels, missing content
+     - **Uncovered ACs**: Acceptance criteria without corresponding `@awa-test`
+
+3. FIX ERRORS
+   - For orphaned markers: locate the marker in code and either fix the ID or add the missing spec entry
+   - For broken cross-references: update the DESIGN spec to reference valid REQ IDs
+   - For schema violations: update the spec file to match the expected structure
+   - For uncovered ACs: add missing `@awa-test` markers or note as intentionally deferred
+
+4. RE-RUN CHECK
+   - Execute `awa check` again to verify all errors are resolved
+   - Repeat fix cycle until exit code is 0
+
+5. REPORT
+   - Summarize what was found and what was fixed
+   - Note any remaining warnings that do not block (exit code 0)
+
+## Outputs
+
+<cli>awa check output (text or JSON)</cli>
+- Fixed source code files (corrected markers)
+- Fixed spec files (corrected cross-references or structure)
+
+## Rules
+
+You SHALL run `awa check` before making any fixes to establish a baseline.
+You SHALL fix all errors (severity: error) before completing.
+You SHALL re-run `awa check` after fixes to confirm resolution.
+You SHALL NOT remove traceability markers to silence errors — fix the root cause instead.
+You SHOULD address warnings when straightforward, but warnings do not block completion.
+You MAY use `awa check --format json` for structured output when analyzing complex results.
+You MAY use todos and tools as needed.
+

package/templates/awa/_partials/awa.code.md

@@ -163,5 +163,6 @@ You SHALL use any tools you need to help write and test code (e.g. MCP tools for
 You MUST add traceability markers (`@awa-component`, `@awa-impl`, `@awa-test`) to all code and tests.
 You MUST ensure every feature implementation traces to at least one acceptance criterion.
 You MUST ensure every test file traces to at least one design property.
+You MUST run `awa check` after implementation to verify all traceability markers resolve to spec IDs and no acceptance criteria are left uncovered.
 You SHALL clarify open points with user.
 You MAY use todos and tools as needed.