Aligning

Check Spec Tree files for conformance to templates, atemporal voice, and content placement rules. Report non-conformances as facts. Do not suggest fixes, rate severity, or prioritize findings.

1. Verify <SPEC_TREE_FOUNDATION> marker is present — if not, invoke /understanding first
2. Read all references and templates from the understanding skill's directory
3. Glob spx/**/*.md (or user-specified scope)
4. Classify each file, check against three dimensions, report findings

1. FACTS ONLY — Report what violates which rule. Never suggest how to fix it. Never rate severity. Never say "should", "consider", or "recommend."
2. RULES FROM UNDERSTANDING — All conformance rules live in the understanding skill's references and templates. This skill owns zero rules. Read them at check time.
3. STRICT CLASSIFICATION — Only .enabler and .outcome are recognized node types. Only .adr.md, .pdr.md, .prd.md/.product.md are recognized decision/product files. Anything else is "unrecognized."
4. COMPLETE SCAN — Check every .md file in scope. Do not skip files. Do not sample.
5. FOUNDATION REQUIRED — The <SPEC_TREE_FOUNDATION> marker must be present. If absent, stop and instruct the user to invoke /understanding first.

All conformance rules come from the understanding skill, a sibling directory to this skill.

The understanding skill is a sibling directory to this skill. Its files are at:

${SKILL_DIR}/../understanding/

References (conformance rules):

• ${SKILL_DIR}/../understanding/references/durable-map.md — <atemporal_voice> section: temporal markers table and read-aloud test
• ${SKILL_DIR}/../understanding/references/what-goes-where.md — <common_misplacements> table: content in wrong artifact type
• ${SKILL_DIR}/../understanding/references/node-types.md — <enabler> and <outcome> sections: directory suffix classification

Templates (structural rules):

• ${SKILL_DIR}/../understanding/templates/decisions/decision-name.adr.md — required ADR sections
• ${SKILL_DIR}/../understanding/templates/decisions/decision-name.pdr.md — required PDR sections
• ${SKILL_DIR}/../understanding/templates/product/product-name.product.md — required product sections
• ${SKILL_DIR}/../understanding/templates/nodes/enabler-name.md — required enabler sections
• ${SKILL_DIR}/../understanding/templates/nodes/outcome-name.md — required outcome sections

If you cannot find understanding's files:

1. Glob: ${SKILL_DIR}/../understanding/references/*.md
2. Do NOT look in the user's project directory for references or templates

Classify each .md file in scope by its filename extension or parent directory suffix:

Spec file means the file whose name matches the directory slug. Example: auth.md inside 10-auth.enabler/. Other .md files in the directory (like CLAUDE.md) are not spec files — skip them.

Unrecognized includes directories with suffixes like .capability, .feature, .story. These are not Spec Tree node types. Report the classification failure as a finding.

Files to skip entirely:

• CLAUDE.md files (project configuration, not specs)
• Files inside tests/ directories (test code, not specs)

Compare each classified file's ## headings against its template's ## headings.

Report as findings:

• Missing section: Template has ## Purpose but file does not
• Name mismatch: File has ## Problem where template expects ## Purpose
• Unrecognized assertion type: Assertion heading not in the five types (Scenarios, Mappings, Conformance, Properties, Compliance)

Do NOT report:

• Extra sections beyond the template (specs may have project-specific additions)
• Missing optional sections (templates mark optional sections with "Only include if...")

Read the <atemporal_voice> section from durable-map.md. It provides two checking mechanisms:

A. Temporal markers table — The left column lists specific phrases to find. Scan every line for matches.

B. Read-aloud test — "Read any sentence aloud. If it would sound wrong after the work is done, it's temporal." Apply to each non-template sentence.

Common temporal patterns caught by the read-aloud test that may not appear in the markers table:

• "supersedes" / "replaces" / "deprecated" (narrates history of decisions)
• "previously" / "used to" / "was" / "has been" (past tense narration)
• "going to" / "will need to" / "plan to" (future intentions)
• "migrate" / "transition" / "phase out" (describes a journey)
• Problem framing: "Users face X" / "X is broken" / "X causes Y" (narrates a gap to fill)

Report as findings:

• Line number, the temporal text, which rule it violates (specific marker or read-aloud test)
• Reference: (ref: atemporal_voice)

Do NOT report:

• Template placeholder text (e.g., {1-3 sentences: what concern...})
• Content inside code fences
• Content inside HTML comments

Read the <common_misplacements> table from what-goes-where.md. For each row, check whether the file contains content that belongs elsewhere.

Key signals:

Report as findings:

• File, approximate location, what content was found, where it belongs per the table
• Reference: (ref: what-goes-where)

1. Gate: Check conversation for <SPEC_TREE_FOUNDATION> marker. If absent, stop: "Invoke /understanding first."
2. Load rules: Read all references and templates listed in <accessing_references> from the understanding skill's directory.
3. Scope: Use user-specified path, or default to spx/ in the project root.
4. Discover: Glob {scope}/**/*.md to find all markdown files. Exclude CLAUDE.md files and files inside tests/ directories.
5. Classify: Map each file to its artifact type per <file_classification>.
6. Check each file:
   • If classified: run structural, language, and placement checks
   • If unrecognized: report classification failure, then run language check only (language rules apply to all text)
7. Report: Emit findings grouped by file path per <report_format>.
8. Summary: End with counts.

## Alignment Report: {scope}

### {file path}
Classification: {type}

Structural:
- {finding}

Language:
- Line {N}: "{text}" — {rule violated} (ref: atemporal_voice)

Placement:
- {finding} (ref: what-goes-where)

---

{N} files checked. {M} findings across {K} files.

Formatting rules:

• Omit dimension headings (Structural / Language / Placement) when a file has no findings for that dimension
• Omit files with zero findings entirely
• If all files pass all checks: "0 findings."
• For unrecognized files, replace the Classification line with: Classification: Unrecognized — {reason}

• <SPEC_TREE_FOUNDATION> marker verified present
• All references and templates read from understanding skill
• Every .md file in scope classified or reported as unrecognized
• Structural checks run against correct template per file type
• Language checks applied to all files (including unrecognized)
• Placement checks applied to all classified files
• Report contains only factual findings — no suggestions, no severity, no "should"
• Summary counts emitted