Skip to content

v0.1.1: SKILL.md expansion + dogfood-aligned artifact map

Choose a tag to compare

View all tags
@hannsxpeter hannsxpeter released this 09 May 18:02
v0.1.1
66c483b

Patch release that expands SKILL.md to the spec target (1,500-2,000 lines) and aligns the artifact map with the dogfood at aihxp/ready-suite-example.

SKILL.md expansion

From 842 to 1,570 lines. New content (all faithfully consolidated from the source eleven-skill suite, no v2 additions):

  • Mode B routing: ten-step decision tree mapping the current project state to the next tier sub-step.
  • Mode C audit: per-tier audit procedure with severity vocabulary, audit-output canonical paths, and verdict semantics (PASS / PASS WITH FINDINGS / BLOCK).
  • Mode D multi-repo: dispatch protocol with byte-identical-collection-map invariant.
  • Per-tier inline grep tests: mechanical checks for PRD, architecture, roadmap, stack, repo, production, deploy, observe, launch, harden.
  • Per-harness integration: Claude Code, Codex, Cursor, Windsurf, Antigravity, Pi, OpenClaw, generic chat frontend.
  • Worked example: condensed Pulse arc walkthrough (the dogfood, narrated tier by tier).
  • Symptom-to-pattern table: "if X is happening, look for failure mode Y" lookup.
  • Critical-finding gate logic: Tier 3.4 -> Tier 3.3 with grep test.
  • AGENTS.md emit-and-respect rules: across Tier 0 sub-step 6a and Tier 2.1 sub-step 14.
  • Resume protocol elaborated: shell-snippet examples and disk-wins semantics.
  • Per-tier STATE.md schemas: PROGRESS.md plus per-tier session-state shapes.
  • "What good looks like" excerpts: passing-quality examples for every tier (Problem section, ADR, roadmap row, stack recommendation, scaffold, vertical slice, canary, SLO, hero, hardening finding).

Artifact map (dogfood-aligned)

The source eleven-skill suite produces multiple artifacts per tier (e.g., .deploy-ready/ has DEPLOY.md, PLAN.md, TOPOLOGY.md, STATE.md); v0.1.0 was documenting one canonical filename per tier. v0.1.1 reflects the multi-artifact reality:

  • .stack-ready/STACK.md (canonical) alongside DECISION.md variant.
  • .repo-ready/SCAFFOLD.md (canonical) alongside AUDIT-REPORT.md (Mode B audit output).
  • .deploy-ready/{DEPLOY,PLAN,TOPOLOGY,STATE}.md.
  • .observe-ready/{OBSERVE,SLOs,INDEPENDENCE,STATE}.md.

The dogfood at aihxp/ready-suite-example verifies cleanly against arc-ready's tier dispatch with these names.

Why a patch, not a minor

Content deepening, not contract change. Discipline unchanged. No new failure-mode patterns. arc-ready remains faithful consolidation, not v2.

Assets 2
Loading