Skip to content

chore(learning): PF-026 byte-budget headroom record drifted from measured tree #346

Description

@dean0x

Finding

tests/tracker/byte-budget.test.ts measures the binding byte-budget ceilings on this tree as: dist/agents/git.md 58,782/58,870 (88 headroom), GitHub loaded set 80,837/80,944 (107), Jira 88,615/88,660 (45), Linear 90,984/91,000 (16, binding). PF-026's 2026-09-17 amendment records every row exactly 10 characters more generous (headroom 98/117/55/26).

Why deferred

PF-026 lives in .devflow/learning/pitfalls.md, which is gitignored and outside this diff. Per ADR-022, the observation log (decisions-log.jsonl) is the content authority — pitfalls.md is rendered from it via the ledger ops (assign-anchor/refresh-anchor). A Code agent must never hand-edit pitfalls.md or the ledger directly. The correction belongs to the Learning agent's refresh-anchor path, which re-projects the log row and re-renders.

Suggested fix

Do not hand-edit pitfalls.md. Next time the Learning agent processes an observation touching PF-026, it should re-verify the measured headroom against tests/tracker/byte-budget.test.ts and refresh the anchor's recorded values via refresh-anchor.

References

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    tech-debtTechnical debt items to address

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions