ll-skills 2.0.2 → 3.0.0

package/scripts/fixtures/auto-decisions/decisions/DEC-0001-taken-alone.md

@@ -0,0 +1,13 @@
+# DEC-0001 — retry policy for the provider adapter
+
+- Date: 2026-09-10
+- Decided by: the run, under `--auto-decision`
+- status: DECIDED — three retries with exponential backoff [decided by absence — revisable]
+
+## Decision
+
+The adapter retries a failed provider call three times with exponential backoff.
+
+## Why
+
+The recommended option of the open question; nobody answered before the run reached the stage.

package/scripts/fixtures/auto-decisions/decisions/DEC-0002-owner.md

@@ -0,0 +1,13 @@
+# DEC-0002 — the reconciliation window is 24 hours
+
+- Date: 2026-09-10
+- Decided by: the owner, in free text
+- status: DECIDED — 24 hours
+
+## Decision
+
+The reconciliation job compares a 24-hour window, not a calendar day.
+
+## Why
+
+The owner answered the question directly, so no marker is carried here.

package/scripts/fixtures/auto-noroadmap/PLAN.md

@@ -0,0 +1,20 @@
+# PLAN — fixture without ROADMAP
+
+Three phases or fewer: the phase table lives inline in §8, there is no ROADMAP.md.
+
+## §7 Execution protocol
+
+Session fable/high; contract executor opus/high.
+
+## §8 Phases
+
+| phase | name | requirements | state |
+|---|---|---|---|
+| 01 | intake | REQ-a | DONE (docs/history/v1.0) |
+| 02 | reporting | REQ-b | ACTIVE |
+
+Current phase: 02.
+
+## §9 Environment
+
+`FIXTURE_KEY` (name only, never the value).

package/scripts/fixtures/auto-noroadmap/PROGRESS.md

@@ -0,0 +1,11 @@
+# PROGRESS — fixture without ROADMAP
+
+<!-- ll-state -->
+phase: 02
+milestones:
+  M1: { passes: false, reason: "not started" }
+<!-- /ll-state -->
+
+## Phase 02
+
+- [2026-09-09T09:00Z] phase 02 opened — reporting

package/scripts/fixtures/auto-verify-next/PLAN.md

@@ -0,0 +1,5 @@
+# PLAN — fixture whose epilogue asks for the audit
+
+## §8 Phases
+
+See ROADMAP.md. Current phase: 01.

package/scripts/fixtures/auto-verify-next/PROGRESS.md

@@ -0,0 +1,18 @@
+# PROGRESS — fixture whose epilogue asks for the audit
+
+<!-- ll-state -->
+phase: 01
+milestones:
+  M1: { passes: true, commit: a1b2c3d, accepted_at: 2026-09-09T10:00:00Z }
+  M2: { passes: false, reason: "acceptance red: 1 test fails" }
+<!-- /ll-state -->
+
+## Phase 01
+
+- [2026-09-09T09:00Z] phase 01 opened — intake
+
+## Epilogue — phase 01 — 2026-09-09
+
+passed: M1 · left: M2 (acceptance red)
+milestones passed 1/2 · questions asked 0 / assumptions 0 / band-1 open 0 · amendments 0 · verification: pending
+▶ Next — `/clear`, then `ll-verify 01`

package/scripts/fixtures/auto-verify-next/ROADMAP.md

@@ -0,0 +1,5 @@
+# ROADMAP — fixture whose epilogue asks for the audit
+
+| phase | name | depends_on | requirements | state |
+|---|---|---|---|---|
+| 01 | intake | — | REQ-a | ACTIVE |

package/scripts/fixtures/auto-verify-next/phases/01/PLAN.md

@@ -0,0 +1,6 @@
+# PLAN — phase 01
+
+## Milestones
+
+M1 — intake · acceptance: `npm test -- intake.test.ts` · tdd: yes
+M2 — reporting · acceptance: `npm test -- report.test.ts` · tdd: yes

package/scripts/fixtures/evals-auto/auto-dry-run/pass.txt

@@ -0,0 +1,18 @@
+research     todo  no docs/research-*/SUMMARY.md
+brainstorm   todo  no docs/decide/OPENING.md
+decide       done  PLAN.md + PROGRESS.md ll-state block
+phase-05     done  ROADMAP row: DONE (docs/history/v1.0)
+phase-06     done  ROADMAP row: DONE (docs/history/v1.0)
+phase-07     half  epilogue over a board with M2, M3 not passing
+phase-08     todo  ROADMAP row: PLANNED
+verify-05    todo  no phases/05/VERIFICATION.md
+verify-06    todo  no phases/06/VERIFICATION.md
+verify-07    todo  no phases/07/VERIFICATION.md
+verify-08    todo  no phases/08/VERIFICATION.md
+close        todo  no docs/DELIVERY.md
+
+1. phase-07     ll-implement 07 --no-talk
+2. phase-08     ll-implement 08 --no-talk
+3. close        ll-close --no-talk
+
+Dry run: the roteiro above is the plan; nothing was written.

package/scripts/fixtures/evals-auto/auto-empty-repo/pass.txt

@@ -0,0 +1,2 @@
+Nada encontrado neste repositório: sem pesquisa, OPENING.md nem PLAN.md.
+/ll-auto "<objetivo>" [--research] [--brainstorm]

package/scripts/fixtures/evals-auto/goal-autonomous/pass.txt

@@ -0,0 +1,29 @@
+docs/GOAL.md written and committed (mode: autonomous, phase: all). Paste this text into the
+unattended run:
+
+/goal Deliver what ROADMAP.md still owes — phases 07 and 08 — to main, tested, per PLAN.md.
+
+DONE WHEN: docs/DELIVERY.md exists; PROGRESS.md carries ## Epilogue — phase 08; phases/07 and
+phases/08 VERIFICATION.md say APPROVED or APPROVED_WITH_RESERVATIONS; docs/AUTO.md has every roteiro
+row done or skipped and ## Decisions taken alone filled; `npm test` exit 0; `git status --porcelain`
+empty — each pasted here as its last output line. Or stop after 80 turns, saying what is missing.
+
+READ FIRST: PLAN.md (§0, §2, §3, §7), ROADMAP.md phases 07 and 08, docs/AUTO.md when it exists.
+
+INVALIDATING: deleting, weakening, skipping or marking as skip any test, acceptance or threshold;
+self-validation instead of a clean-context verifier; a TODO or "phase 2" left in a milestone marked
+done; partial delivery counted as done. Impossibility without an implemented alternative does not
+complete the goal.
+
+EXECUTION: skill ll-auto --auto-decision --verify all, started again from this text whenever the
+session stops before DONE WHEN. Models per role from PLAN.md §7.
+
+DECISIONS: everything that stays inside the repository is decided, recorded [decided by absence —
+revisable] and listed at the end; money, production data and credentials never proceed alone.
+
+STATE: docs/AUTO.md one log line per stage; PROGRESS.md one block per wave.
+
+STOP: external block (key, host, rate limit, an answer only the owner has) = record the state in
+PROGRESS.md and STOP without marking done.
+
+▶ Next — `/clear` then paste the text above into the unattended run.

package/scripts/fixtures/lint-bad/folded-description/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: ll-fake
+description: >
+  Pretends to describe a skill in a folded scalar.
+
+  The blank line above keeps a newline inside the value, which rule 1 must reject.
+argument-hint: "[none]"
+disable-model-invocation: true
+---
+
+# Folded description
+
+Fixture for lint-prompts rule 1: the description is not one line.

package/scripts/fixtures/lint-bad/model-invocation-false/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: ll-fake
+description: Pretends to be a manual skill while the frontmatter leaves the model free to invoke it, which rule 1 must reject.
+argument-hint: "[none]"
+disable-model-invocation: false
+---
+
+# Model invocation left open
+
+Fixture for lint-prompts rule 1: disable-model-invocation is declared false.

package/scripts/fixtures/next-bad/skills/ll-bad/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: ll-bad
+description: Fixture for lint-contract rule 6 — handoff lines that the Next grammar must reject, one break per line.
+argument-hint: "[none]"
+disable-model-invocation: true
+---
+
+# Bad handoffs
+
+Each line below breaks the grammar in one way, so rule 6 must print one FAIL for each.
+
+Old shape, backticks around /clear and around a skill that does exist:
+
+▶ Next — `/clear` then `ll-bad`
+
+Bare command, no `/clear, then` opening:
+
+▶ Next — ll-bad
+
+Right grammar, command that names no skill in this tree:
+
+▶ Next — /clear, then ll-nope
+
+Right grammar, but the same skill twice outside a parenthetical:
+
+▶ Next — /clear, then ll-bad or ll-bad --resume
+
+Same grammar, two different skills to choose between, still outside a parenthetical:
+
+▶ Next — /clear, then ll-bad or ll-nope --resume

package/scripts/fixtures/next-good/skills/ll-good/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: ll-good
+description: Fixture for lint-contract rule 6 — one line per allowed form of the Next grammar.
+argument-hint: "[none]"
+disable-model-invocation: true
+---
+
+# Good handoffs
+
+Plain command:
+
+▶ Next — /clear, then ll-good
+
+Arguments, with the alternatives inside one parenthetical:
+
+▶ Next — /clear, then ll-good 3 --wave 2 (or ll-good --resume)
+
+The /goal target, followed by text:
+
+▶ Next — /clear, then /goal <text>
+
+A placeholder in angle brackets, when the epilogue names the command:
+
+▶ Next — /clear, then <the command the epilogue names>
+
+Wrapped in backticks inside prose: the epilogue ends with `▶ Next — /clear, then ll-good --resume` and nothing follows it.

package/scripts/fixtures/project/PROGRESS.md

@@ -50,8 +50,12 @@ not_verified: backoff under real network latency
 
 - SC-03 load under 10k rows · `ll-verify --criterion SC-03` · born phase 05
 
+- [2026-01-05T10:00:00Z] owner: pode ir
+- [2026-01-05T11:00:00Z] owner: troca o nome da coluna
+
 ## Epilogue — phase 07 — 2026-09-09
 
 passed: M1 · left: M2 (acceptance red), M3 (BLOCKED: DEC-0041) · WAITING: DEC-0041 (cents rounding) ·
 new backlog: B-014, B-015 · actions that need you: decide DEC-0041 before wave 3
+milestones passed 2/3 · questions asked 3 / assumptions 1 (ASM-1) / band-1 open 0 · amendments 1 · verification: phases/07/VERIFICATION.md APPROVED
 ▶ Next — `/clear`, then `ll-implement 8`