Skip to content

STATUS.md: root cold-start surface for WIP + goals, async-first write-back rule - #571

Merged
pftg merged 6 commits into
masterfrom
feature/status-md-async-first
Aug 22, 2026
Merged

STATUS.md: root cold-start surface for WIP + goals, async-first write-back rule#571
pftg merged 6 commits into
masterfrom
feature/status-md-async-first

Conversation

@pftg

@pftg pftg commented Aug 22, 2026

Copy link
Copy Markdown
Member

Summary

Paul asked (via /claude-md-improver): make async-first always followed, and give anyone landing in the repo one surface that answers "what's in flight and what are the goals", tracked concisely without rot.

Design (Paul approved all three via in-session vote): root STATUS.md, repo-work scope (the vault still owns company operations — this surface links, never copies); project CLAUDE.md + one global line; rule-only freshness enforcement mirroring the OKF same-commit wording.

Per-commit

  1. a20bca87 — STATUS.md (new) + CLAUDE.md/AGENTS.md pointer + write-back rule + async-first SKILL surfaces row + OKF concept/log; fixed stale 2607 T9 row found during fact-check.
  2. d171dff4 — full active-project review (all six docs/projects audited against their own trackers): 2605/2510 rows sharpened, "Not in flight" line (2604 closed, 2509 dormant), two real Paul blockers surfaced.
  3. a37e4799 — AGENTS.md phantom .agent/ onboarding stack removed (files never existed; verified with find).
  4. 97655240 — reviewer round-2 findings: LinkedIn is LIVE (3 posts, ledger-verified) not "drafts only"; blog row now defers to 20.09 §1 (outreach outranks posts) + §13 queue; stale sources corrected (2605 tracker line, ICP plan "zero posted" banner); Joy Adamson override + header rule "verify against the artifact, never a tracker line".
  5. da2b16c3 — round-3: POSTING-PACKET retitled HISTORICAL with dated supersession above its paste block (it offered a Paul-rejected draft as copy-paste-ready); ICP-E count measured from frontmatter (1 posted + 4 approved).
  6. 75bc4312 — round-4 residual: last live "zero posted/PULLED" claim in the 2605 tracker stamped; every remaining rg "zero posted" hit is now superseded in place.

Gates

  • bin/hugo-build exit 0 (re-run on final tree). Docs-only diff — CI intentionally skips (all three workflows' path filters exclude these paths); local gates are the gates of record.
  • OKF validator: conformant, 0 ERRORS (120 pre-existing warnings, known-red --strict state per log.md).
  • marketing-copy ratchet: root *.md not in SURFACES; STATUS.md carries links, no company claims.
  • All STATUS.md link targets resolve; 38 lines (≤50 cap).

Review provenance

4-eyes satisfied: author (this session) ≠ verifier (status-diff-reviewer sub-agent), five measured rounds (FAIL → FAIL → FAIL → FAIL → PASS at 75bc4312). The reviewer's recurring-mechanism diagnosis — stale tracker lines copied into STATUS.md inherit their staleness — is now a rule in STATUS.md's own header, and every stale source it uncovered (2607 T9, 2605 tracker ×2, ICP plan banner, POSTING-PACKET) is stamped at the source. A second clean-context review from a peer session is in flight; its findings land as follow-up per the written contract.

🤖 Generated with Claude Code

@coderabbitai

coderabbitai Bot commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5b4c1443-cce8-4842-9695-2a3d60aa5860


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

pftg and others added 6 commits August 22, 2026 11:59
…-back rule

Paul asked (via /claude-md-improver) that anyone landing in the repo can see
what's in flight and what the goals are, with concise, maintained ops tracking.

- STATUS.md (new, 32 lines): goals (links), Now/WIP table, Blocked-on-Paul —
  links only, repo-work scope; the vault still owns company operations
  (2026-08-20 rule unchanged; this surface points, never copies).
- CLAUDE.md / AGENTS.md: pointer near the top + same-commit update rule folded
  into the existing async-first bullet (mirrors the OKF enforcement wording).
- async-first SKILL.md: STATUS.md row added to the canonical surfaces table.
- OKF: company-layer-ownership concept section + dated log entry (same commit,
  per the ENFORCED rule).
- 2607 backlog: T9 row said Ready while the §Done roll-up and the deliverable
  file said done — fixed the stale side (found during STATUS.md fact-check).

Gates: bin/hugo-build exit 0; OKF validator 0 ERRORS (120 pre-existing
warnings, known-red --strict state per log.md); marketing-copy ratchet does
not glob root *.md and STATUS.md carries no company claims; all 7 STATUS.md
link targets resolve.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Per Paul's follow-up: reviewed every project under docs/projects/ against its
own tracker and recent git history, not memory.

- 2605: state corrected to "v2 live + measuring; arrival-not-content diagnosis
  (2026-08-20 triple read)"; next step from 50.05, not generic backlog.
- 2510: state sharpened — R-queue restocked from live GSC 2026-08-21 (#524).
- Added "Not in flight" line: 2604 closed 2026-08-08; 2509 Phase D dormant,
  superseded in practice by the 2608 clean-slate rail (ADR-0006).
- Blocked-on-Paul gained two real items found in trackers: the three 2605
  fabricated-fact findings (Aug-20 sweep) and the empty LinkedIn
  metrics-ledger row for the 2026-08-13 post.

36 lines; all link targets verified with ls.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The audit agent flagged and `find` confirmed: no .agent/STATUS.md,
.agent/prd/PRD.md, or .agent/tasks.json exists anywhere under docs/projects/ —
the documented onboarding order pointed at files that never existed. Replaced
with the real surfaces: root STATUS.md (cross-project), the project README /
GOAL-AT-A-GLANCE (2608's README is the template), then TASK-TRACKER/backlog.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…acker lines

The 4-eyes reviewer FAILed round two with measurements; every finding fixed:

- P0-1: LinkedIn is LIVE, not drafts-only — metrics-ledger carries 3 posted
  rows (08-13/18/19, first read 2026-08-20) incl. the ICP-E lane's own
  week1-mon post; row now leads the WIP table as the primary demand lane.
- P0-2: blog row no longer says "next post from the R-queue" (20.09 says the
  R-queue is empty/retired; replacement is §13) and now carries §1's governing
  constraint: outreach outranks new posts. §1 is reflected, not superseded.
- P1-3: dropped the "empty metrics-ledger row" Paul ask (filled 2026-08-20)
  and corrected the stale 2605 TASK-TRACKER line it was copied from.
- P1-4: 2607 next step is the backlog's actual recommendation — Sept-restart
  decision to retire the cold lane or buy Reddit API — not a P7 re-run.
- P1-5: Joy Adamson override added to Blocked-on-Paul (1-min item, live).
- P2-6: bet status no longer copied from vault ownership — Goals row now
  points at jt-vcr-runbook + the docs/business mirror instead of asserting it.
- P2-7: "16 drafts" (all-lanes) corrected to ICP-E's own 3/10.
- Reviewer's mechanism note adopted: header now instructs updaters to verify
  against the artifact, never a tracker line.

Also superseded the ICP plan's stale "zero posted" status with a dated update
note pointing at the ledger.

41 lines; all link targets verified with ls.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…m disk

- P0-8: the packet still said PULLED / clock-NOT-started and offered the
  deleted 08-13 parable as the paste block, while the revised post shipped
  2026-08-18 (posted_url in week1-mon frontmatter, ledger row read 08-20).
  Retitled HISTORICAL, dated supersession note added above the paste block,
  the "copy-paste-post" instruction struck through. STATUS.md next step now
  routes to the approved drafts (week1-tue / week1-wed), not the packet.
- P2-9: "3/10 drafted" (copied from the plan banner) replaced with the
  on-disk truth: 1 posted + 4 approved (of 10 planned) — measured from
  frontmatter status fields, not a tracker line.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…racker

Third and final instance of the stale-claim class (rg "zero posted" now finds
only lines directly superseded in place by dated stamps). Item 0 gains a
2026-08-22 update: revised post shipped 08-18, 3 live, clock running,
packet is HISTORICAL.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@pftg
pftg force-pushed the feature/status-md-async-first branch from 75bc431 to 2f8bd60 Compare August 22, 2026 09:59
@pftg
pftg merged commit 44e1ad3 into master Aug 22, 2026
3 checks passed
@pftg
pftg deleted the feature/status-md-async-first branch August 22, 2026 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant