Skip to content

feat(skills): add specsmith self-referential skills, fix install subdirectory format (#190)#192

Merged
tbitcs merged 6 commits into
developfrom
feat/190-specsmith-self-referential-skills
May 30, 2026
Merged

feat(skills): add specsmith self-referential skills, fix install subdirectory format (#190)#192
tbitcs merged 6 commits into
developfrom
feat/190-specsmith-self-referential-skills

Conversation

@tbitcs
Copy link
Copy Markdown
Contributor

@tbitcs tbitcs commented May 30, 2026

REQ-360 / REQ-361: Self-referential skills + subdirectory install format

Changes

Part 1: Three new SkillEntry items in governance.py

  • specsmith — Master governance CLI reference (session workflow, commands, audit codes)
  • specsmith-audit — Drift detection and governance health
  • specsmith-save — Governance-aware save workflow

Part 2: install() subdirectory format

  • install() now writes /SKILL.md instead of .md for Warp/Claude Code/Codex auto-discovery
  • installed_skills() detects both flat (legacy) and subdirectory formats

Part 2b: CLI update

  • skill_list CLI command updated to handle both formats for installed skills display

Part 3: skills-index.md

  • Governance count updated from 11 to 14, three new rows added in alphabetical order

Part 4: AGENTS.md

  • New "Agent Skills" section with install commands and remote reference

Part 5: CHANGELOG.md

  • New [Unreleased] section with REQ-360/REQ-361 entry

Part 6: README.md

  • New "Skills" section with self-referential skills table and remote reference

Part 7: Tests

  • 5 new tests: catalog presence, domain check, subdirectory format, flat format detection
  • Updated existing tests for subdirectory format (paths, assertions)
  • All 23 tests pass

Conversation: https://app.warp.dev/conversation/51d0ea45-320b-4044-a698-693f7716da9d
Run: https://oz.warp.dev/runs/019e76b9-66a0-7941-855e-6d46d33a02b2

This PR was generated with Oz.

tbitcs and others added 6 commits May 29, 2026 22:34
…llback

REQ-359: Widen _req_count regex from ^###\s+REQ- to ^#{2,3}\s+REQ- so
H2-style requirement headings (## REQ-BE-001) are counted alongside H3.

REQ-358: In run_sync() YAML-first mode, fall back to parsing
REQUIREMENTS.md when no YAML requirement files exist but the Markdown
file contains >=5 REQ-* references. Also falls back for tests.

Co-Authored-By: Oz <[email protected]>
Add generic accepted_warnings suppression to the audit pipeline:
- AuditResult gains suppressed field; AuditReport gains suppressed_count
- _SUPPRESSION_ALIASES maps scaffold.yml alias names to check names
- _apply_accepted_warnings marks matching results as suppressed+passed
- run_audit reads accepted_warnings + audit_suppressions from scaffold.yml
- check_ledger_health no longer manually checks audit_suppressions
- run_auto_fix skips suppressed results
- CLI shows ~ icon and (accepted) suffix for suppressed checks
- 4 new tests covering aliases, backward compat, and properties

Co-Authored-By: Oz <[email protected]>
…irectory format (#190)

REQ-360/REQ-361: Add three built-in skills (specsmith, specsmith-save,
specsmith-audit) to the governance skills catalog. Update install() to
write <slug>/SKILL.md (subdirectory format) for Warp/Claude Code/Codex
auto-discovery. Update installed_skills() to detect both flat and
subdirectory formats. Update CLI skill list to handle new format.
Update docs and tests.

Co-Authored-By: Oz <[email protected]>
#188 (feat/auditor): scaffold.yml accepted_warnings suppression — AuditResult.suppressed
  field, _apply_accepted_warnings(), CLI renders ~ (accepted). Aliases: scaffold_type_mismatch,
  ledger_line_threshold, open_todo_count.

#189 (fix/phase+sync): _req_count now detects ## REQ- H2 headings (was ### only).
  specsmith sync falls back to Markdown parsing in YAML mode when YAML files are absent.

#190 (feat/skills): specsmith/specsmith-save/specsmith-audit added to built-in catalog.
  install() now writes <slug>/SKILL.md (subdir format). installed_skills() detects both
  formats. AGENTS.md, CHANGELOG.md, README.md, skills-index.md updated. conftest.py
  adds SPECSMITH_ALLOW_NON_PIPX=1 autouse so CLI tests pass under dev installs.

REQ-357, REQ-358, REQ-359, REQ-360, REQ-361 implemented. Tests: 868 pass.

Co-Authored-By: Oz <[email protected]>
@tbitcs tbitcs merged commit 8273dd4 into develop May 30, 2026
16 checks passed
@tbitcs tbitcs deleted the feat/190-specsmith-self-referential-skills branch May 30, 2026 02:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant