Skip to content

platform-checklist: carry implementation STATUS in the ledger — status: planned for capabilities the North Star's definition requires but the platform does not yet verify; RUNNER skips them, coverage does not count them, one command lists the state per area #19157

Description

@os-elon-musk

Path: none

Maintainer ruling (chat, 2026-09-19), verbatim: 「感觉 platform-checklist 不是很合适,我们是不是应该维护一个平台真的功能清单,以及实现状态。」 → seat proposal: no second document; add the status axis to the existing ledger → 「同意,立卡」.

Why

docs/qa/platform-checklist/areas/*.json holds 264 items, all status: active — the ledger records only implemented, verified capabilities. The North Star's definition line (「做出来的是什么」… 「缺任何一样就不是这个应用」) makes a missing piece of a listed capability a requirement, but the ledger has nowhere to hold it, so (a) the backlog sweep has nowhere to point a capability-gap card and (b) the platform's implementation status lives in nobody's head. A separate feature list would drift against the ledger (the ADR-0136 lesson; the North Star: 「本页不带任何数字;数字从命令来」). One ledger, one id space, one more status.

仪器 question (北极星「仪器为车队服务」): which fleet decision differs — the disposition of every capability-gap card in the live two-repo sweep (keep with a Path: to a planned item vs. closed as 「不在清单上」), and where checklist-author writes a gap it finds. ⇒ p1 (blocks the sweep's 「待补账本」 column).

Scope

  1. Item schema (docs/qa/platform-checklist/README.md, the item field table): status gains planned — a capability the definition requires, not yet implemented or not yet verified; a planned item carries id, area, title, priority, personas, since: null (or the target release), and NO steps until it is implementable. Existing values keep their meaning; every current item stays active.
  2. docs/qa/platform-checklist/RUNNER.md + .claude/skills/checklist-test/SKILL.md: a planned item is skipped by every selector and reported as planned in the run record, never as pass/fail/blocked.
  3. scripts/check-platform-checklist.mjs + coverage.json: a planned item does not count as coverage for any governed metadata kind (a kind mapped only to planned items is still UNMAPPED); the check's self-test pins both directions.
  4. .claude/skills/checklist-author/SKILL.md: the five-angle coverage sweep writes a gap under a definition item as a planned item (title, area, priority) instead of leaving it in a comment; promotion planned → active happens only with a run record in which the item passed.
  5. One command (e.g. pnpm checklist:status, or a --status mode of the existing check) that prints, per area, the counts of active / planned items and lists the planned ids — the 「平台功能清单 + 实现状态」 view is this command's output, not a hand-maintained page.
  6. The North Star's 「账本」 sentence is untouched (the ledger is still docs/qa/platform-checklist/); AGENTS.md untouched unless a pointer there names the status axis (then Tier H).

Acceptance

  • A fixture area file with one planned item: check-platform-checklist.mjs green with the kind still mapped by an active item, RED (unmapped) when the kind's only item is planned; the RUNNER selector on that area reports the item as planned and runs nothing for it.
  • Status command output for the current tree: 264 active · 0 planned across 15 areas (numbers from the command, not typed anywhere).
  • pnpm check:doc-authoring, check:pm-skill-ratchet (the two skills' ceilings), check:pm-skill-id-lint, check:skill-frame-sync green.

Relations


Generated by Claude Code

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions