Correct os-sdlc documents and skill text that disagree with the code #1717

New issue

Open

opened 2026-11-12 20:13:44 +00:00 by jared · 0 comments

jared commented

2026-11-12 20:13:44 +00:00

Owner

Problem

Nine statements in the os-sdlc documents and skill files disagree with the code. A reader or an agent that follows them runs a command that does not exist or follows a retired procedure. The survey for the user guide plugins/os-sdlc/README.md found them on 2026-11-12. The user guide work did not correct them.

Observed

docs/implementation-status/os-sdlc.md "Current shape" describes three stage agents, the os-sdlc-runner gate <dispatch_id> CLI, and a .sdlc/<n>.yml artifact. plugins/os-sdlc/bin/os-sdlc-runner does not exist. plugins/os-sdlc/agents/ holds 23 agents.
docs/implementation-status/os-sdlc.md or docs/sdlc-fast-path.md names these CLIs, which are not in plugins/os-sdlc/bin/: lint-clean, lint-init, lint-rule, lint-lessons, lint-extraction-loop, crc-ledger-check, os-sdlc-mutation-survivors. The survey did not confirm which file names each one.
plugins/os-sdlc/skills/fix-lints/SKILL.md says that flay and debride are installed globally with no Gemfile. The plugin Gemfile lists both.
plugins/os-sdlc/skills/setup-project/SKILL.md has a name: frontmatter field. plugins/cc-architect/references/conventions/cc-os-naming.md forbids it.
plugins/os-sdlc/skills/mine-lints/SKILL.md files tickets through tea. The repository rule is the os-backlog CLI.
plugins/os-sdlc/.mutineer.yml sets matrix: true. os-sdlc-mutation-pass defaults to --no-matrix.
The survey found no map or skill that dispatches the reviewer agent or the wiring agent. This is a survey result, not a proof.
plugins/os-sdlc/maps/structure-change.yaml fits category/structure tickets. plugins/os-sdlc/skills/implement/SKILL.md sends those tickets to fast-batch and permits only two map values. The survey did not find when the map is used. #1224 (delete the structure-change map) covers this item; rule it against #1224 and drop it here if #1224 lands first.
plugins/os-sdlc/OVERVIEW.md says v0.2. plugins/os-sdlc/.claude-plugin/plugin.json says 0.1.0.

Reproduce

n/a: documentation and skill text; compare each statement with the named file.

Approach

Check each item against the source. Correct the text, or record that the current text is intended. Items 7 and 8 can end as a removal or as a ruling that the object stays. After the corrections, make plugins/os-sdlc/README.md agree with the result.

Required work: none beyond the acceptance criteria.

Acceptance criteria

Given the nine items, when a reader compares each statement with the code, then each statement agrees with the code or the ticket records a ruling that the statement is intended.

Origin

Trigger: the three read-only survey agents that the session ran before it wrote plugins/os-sdlc/README.md.
Improvised this session: none. The user guide omits each claim that the survey did not verify.
Chain: stale statements ← the documents were not updated when the runner dispatcher was retired and the CLIs were renamed (ADR-0232 for the runner; the other renames have no source found) ← IMPROVISATION (no step in the change process named these documents).
Root candidate: none found; searched implementation-status/os-sdlc, sdlc-fast-path, fix-lints, mine-lints, setup-project, OVERVIEW.md, os-sdlc-runner, stale, disagree, out of date
Where: docs/implementation-status/os-sdlc.md, docs/sdlc-fast-path.md, plugins/os-sdlc/skills/fix-lints/SKILL.md, plugins/os-sdlc/skills/setup-project/SKILL.md, plugins/os-sdlc/skills/mine-lints/SKILL.md
Session: 51dab4d2-baa2-4777-80e4-82b893470114
Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os-plugins-os-sdlc/51dab4d2-baa2-4777-80e4-82b893470114.jsonl

VERDICT: CREATE — the nine stale statements are observed; a fix removes the problem; no open ticket covers the same mechanism (#1224 overlaps item 8 only).

## Problem Nine statements in the os-sdlc documents and skill files disagree with the code. A reader or an agent that follows them runs a command that does not exist or follows a retired procedure. The survey for the user guide `plugins/os-sdlc/README.md` found them on 2026-11-12. The user guide work did not correct them. ## Observed 1. `docs/implementation-status/os-sdlc.md` "Current shape" describes three stage agents, the `os-sdlc-runner gate <dispatch_id>` CLI, and a `.sdlc/<n>.yml` artifact. `plugins/os-sdlc/bin/os-sdlc-runner` does not exist. `plugins/os-sdlc/agents/` holds 23 agents. 2. `docs/implementation-status/os-sdlc.md` or `docs/sdlc-fast-path.md` names these CLIs, which are not in `plugins/os-sdlc/bin/`: `lint-clean`, `lint-init`, `lint-rule`, `lint-lessons`, `lint-extraction-loop`, `crc-ledger-check`, `os-sdlc-mutation-survivors`. The survey did not confirm which file names each one. 3. `plugins/os-sdlc/skills/fix-lints/SKILL.md` says that flay and debride are installed globally with no Gemfile. The plugin `Gemfile` lists both. 4. `plugins/os-sdlc/skills/setup-project/SKILL.md` has a `name:` frontmatter field. `plugins/cc-architect/references/conventions/cc-os-naming.md` forbids it. 5. `plugins/os-sdlc/skills/mine-lints/SKILL.md` files tickets through `tea`. The repository rule is the os-backlog CLI. 6. `plugins/os-sdlc/.mutineer.yml` sets `matrix: true`. `os-sdlc-mutation-pass` defaults to `--no-matrix`. 7. The survey found no map or skill that dispatches the `reviewer` agent or the `wiring` agent. This is a survey result, not a proof. 8. `plugins/os-sdlc/maps/structure-change.yaml` fits `category/structure` tickets. `plugins/os-sdlc/skills/implement/SKILL.md` sends those tickets to fast-batch and permits only two map values. The survey did not find when the map is used. #1224 (delete the structure-change map) covers this item; rule it against #1224 and drop it here if #1224 lands first. 9. `plugins/os-sdlc/OVERVIEW.md` says v0.2. `plugins/os-sdlc/.claude-plugin/plugin.json` says 0.1.0. ## Reproduce n/a: documentation and skill text; compare each statement with the named file. ## Approach Check each item against the source. Correct the text, or record that the current text is intended. Items 7 and 8 can end as a removal or as a ruling that the object stays. After the corrections, make `plugins/os-sdlc/README.md` agree with the result. Required work: none beyond the acceptance criteria. ## Acceptance criteria 1. Given the nine items, when a reader compares each statement with the code, then each statement agrees with the code or the ticket records a ruling that the statement is intended. ## Origin - Trigger: the three read-only survey agents that the session ran before it wrote `plugins/os-sdlc/README.md`. - Improvised this session: none. The user guide omits each claim that the survey did not verify. - Chain: stale statements ← the documents were not updated when the runner dispatcher was retired and the CLIs were renamed (ADR-0232 for the runner; the other renames have no source found) ← IMPROVISATION (no step in the change process named these documents). - Root candidate: none found; searched implementation-status/os-sdlc, sdlc-fast-path, fix-lints, mine-lints, setup-project, OVERVIEW.md, os-sdlc-runner, stale, disagree, out of date - Where: `docs/implementation-status/os-sdlc.md`, `docs/sdlc-fast-path.md`, `plugins/os-sdlc/skills/fix-lints/SKILL.md`, `plugins/os-sdlc/skills/setup-project/SKILL.md`, `plugins/os-sdlc/skills/mine-lints/SKILL.md` - Session: 51dab4d2-baa2-4777-80e4-82b893470114 - Transcript: /home/jared/.claude/projects/-home-jared-dev-cc-os-plugins-os-sdlc/51dab4d2-baa2-4777-80e4-82b893470114.jsonl VERDICT: CREATE — the nine stale statements are observed; a fix removes the problem; no open ticket covers the same mechanism (#1224 overlaps item 8 only).

jared added the

plugin/os-sdlc

filed-by/agent

category/prose-artifact

labels

2026-11-12 20:13:44 +00:00