STATUS.md: root cold-start surface for WIP + goals, async-first write-back rule - #571
Merged
Conversation
Contributor
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 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. Comment |
…-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
force-pushed
the
feature/status-md-async-first
branch
from
August 22, 2026 09:59
75bc431 to
2f8bd60
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
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.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.a37e4799— AGENTS.md phantom.agent/onboarding stack removed (files never existed; verified with find).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".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).75bc4312— round-4 residual: last live "zero posted/PULLED" claim in the 2605 tracker stamped; every remainingrg "zero posted"hit is now superseded in place.Gates
bin/hugo-buildexit 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.--strictstate per log.md).*.mdnot in SURFACES; STATUS.md carries links, no company claims.Review provenance
4-eyes satisfied: author (this session) ≠ verifier (
status-diff-reviewersub-agent), five measured rounds (FAIL → FAIL → FAIL → FAIL → PASS at75bc4312). 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