mikoshi-construct 0.3.1 → 0.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mikoshi-construct",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Bootstrap for AI-native software projects. Start with a proven engineering workflow instead of an empty repository.",
   "author": "Eli Tabrisov",
   "license": "MIT",
@@ -42,6 +42,7 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.5.1",
+    "@anthropic-ai/sdk": "^0.127.0",
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.0",
     "@types/node": "^22.18.0",
@@ -54,6 +55,7 @@
     "yaml": "^2.9.1"
   },
   "scripts": {
+    "bench:architect": "tsx scripts/bench/run.ts",
     "build": "tsup",
     "changeset": "changeset",
     "ci": "pnpm run quality",

package/templates/ai/claude/_claude/skills/implement/SKILL.md

@@ -37,7 +37,10 @@ repository's CLAUDE.md and `construct.json`.
    - `degraded` — a rung passed the harness, but a design step was rejected by the schema and the
      run continued without it. The result's `effort` is the class that actually executed.
    - `design incomplete` — a high-effort run whose architect was rejected by the schema. No
-     implementer ran without a spec; the result carries the validator's text in `validationError`.
+     implementer ran without a spec; the result carries the validator's text in `validationError` and
+     the way out in `recovery`, which is a measured route rather than advice: re-running one class
+     lower with the design written into the brief produced the design on three of the three occasions
+     it has been tried on the construct's own repository.
    - `failed` — every rung ran and the harness stayed red; `lastFailure` carries the excerpt.
    - `blocked` — the last rung stopped on a question; `question` carries it verbatim.
 4. Record the run: append one JSON line to `.construct/runs.jsonl` (create the directory if needed)
@@ -66,8 +69,9 @@ repository's CLAUDE.md and `construct.json`.
 5. Relay the result: status, the effort rung that succeeded and how many attempts it took, the
    files changed, and the harness tail. When the status is `blocked`, put the architect's or
    implementer's question to the user verbatim. When `failed`, give the last failure excerpt. When
-   `design incomplete`, say that the design step did not complete and give `validationError` as the
-   runtime reported it; when `degraded`, say which design step was rejected and that the reported
+   `design incomplete`, say that the design step did not complete, give `validationError` as the
+   runtime reported it, and relay `recovery` verbatim — a dead end that names no way out is how the
+   next person decides the ladder is broken rather than that this run needs re-running lower; when `degraded`, say which design step was rejected and that the reported
    class is the one that executed, not the one that was requested.
    Unless `construct.json` sets `report.usage` to `false`, end with one usage line for this run,
    from the Workflow tool's own accounting: agents, subagent tokens, tool uses, wall time — so the

package/templates/ai/claude/scripts/construct/implement.workflow.mjs

@@ -52,6 +52,8 @@ const SPEC = {
   },
 }
 
+const DESIGN_RECOVERY = 'Re-run this task one class lower with the design written into the brief. That is the measured route out: three of three such re-runs on the construct\'s own repository produced the design the architect had failed to return. The run does not retry the design step itself, because a second agent entry pays for the exploration again.'
+
 const DEFAULT_RETRY_LIMIT = 0
 const DESIGN_EFFORT = 'xhigh'
 const EFFORT_WITHOUT_DESIGN = { high: 'medium', xhigh: 'medium' }
@@ -150,7 +152,7 @@ async function design(rung, reason, label) {
     designFailed = true
     designError = lastValidationError ?? ''
     attempts.push({ rung, effort: DESIGN_EFFORT, outcome: 'design schema invalid', reason: designError })
-    log(`${label}: the design step did not complete`)
+    log(`${label}: the design step did not complete. ${DESIGN_RECOVERY}`)
     return false
   }
   spec = result
@@ -165,6 +167,7 @@ function designIncomplete(effort, question) {
     effort: performedEffort(effort),
     attempts,
     validationError: designError,
+    recovery: DESIGN_RECOVERY,
     question: question ?? '',
     lastFailure: feedback ?? '',
   }