Skip to content

Cut the agentic guidance layer to a mission charter - #9381

Open
lunelson wants to merge 5 commits into
ln/fe-1507-topologyfrom
ln/fe-1521-machete-protocol
Open

Cut the agentic guidance layer to a mission charter#9381
lunelson wants to merge 5 commits into
ln/fe-1507-topologyfrom
ln/fe-1521-machete-protocol

Conversation

@lunelson

Copy link
Copy Markdown
Contributor

🌟 What is the purpose of this PR?

🔗 Related links

  • ...

🚫 Blocked by

  • ...

🔍 What does this change?

  • ...

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

  • does not modify any publishable blocks or libraries, or modifications do not need publishing
  • modifies an npm-publishable library and I have added a changeset file(s)
  • modifies a Cargo-publishable library and I have amended the version
  • modifies a Cargo-publishable library, but it is not yet ready to publish
  • modifies a block that will need publishing via GitHub action once merged
  • I am unsure / need advice

📜 Does this require a change to the docs?

The changes in this PR:

  • are internal and do not require a docs change
  • are in a state where docs changes are not yet required but will be
  • require changes to docs which are made as part of this PR
  • require changes to docs which are not made in this PR
    • Provide more detail here
  • I am unsure / need advice

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

  • do not affect the execution graph
  • affected the execution graph, and the turbo.json's have been updated to reflect this
  • I am unsure / need advice

⚠️ Known issues

🐾 Next steps

🛡 What tests cover this?

❓ How to test this?

  1. Checkout the branch / view the deployment
  2. Try X
  3. Confirm that Y

📹 Demo

@vercel

vercel Bot commented Aug 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hash Ready Ready Preview Aug 28, 2026 12:47pm
petrinaut Ready Ready Preview Aug 28, 2026 12:47pm
petrinaut-docs Ready Ready Preview Aug 28, 2026 12:47pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
hashdotdesign-tokens Ignored Ignored Preview Aug 28, 2026 12:47pm

Request Review

lunelson commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

@lunelson
lunelson marked this pull request as ready for review August 27, 2026 15:58
@cursor

cursor Bot commented Aug 27, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Documentation and agent-guidance only; no runtime, auth, or data-path changes. CI could fail if tests still require deleted docs/INDEX.md—not shown updated in this diff.

Overview
Replaces Brunch’s agentic steering / arc-close / wayfinding layer with a mission-first charter: AGENTS.md now centers three laws, a six-field mission contract in MISSION.md, and explicit rules that specs, ADRs, and evidence are reference—not obligations.

Adds MISSION.md (Mission 1: prove Petrinaut ↔ plain Flue chat end-to-end before harness semantics) and docs/adr/README.md framing ADRs as historical hypotheses.

Removes or retires the old control surface: docs/INDEX.md, docs/control/SPEC-LEDGER.md, arc-close skills, and agent protocols for steering, legibility, documentation topology, partition worktrees, triage labels, and arc-close. Trims CONTEXT.md (drops strategic-control and demo-specific glossary) and rewrites surviving git-workflow, issue-tracker, and issue-writing docs around one issue / one branch / one PR with the branch mission as authority.

Updates apps/brunch-agent/AGENTS.md and the context README.md to point agents at MISSION.md and mission-scoped composition instead of mandatory ADR/spec reads.

Reviewed by Cursor Bugbot for commit 32e4234. Bugbot is set up for automated code reviews on this repo. Configure here.

Replace the routing/planning apparatus — 12 protocol docs, three control
docs, the document index, both arc-close skills, and the two tests that
enforced them — with a single compact charter plus a MISSION record.

- AGENTS.md: three laws (real throughline first, deepen only under
  strain, branch = mission), a six-field mission contract, and sharp
  correctives.
- MISSION.md: the current objective, acceptance proof, and stop
  conditions.
- CONTEXT.md trimmed to the live vocabulary; the strategic-control and
  demo vocabulary sections are retired.
- ADRs reframed as hypotheses, not obligations (docs/adr/README.md).
- Flue routing table retained as reference under docs/reference/architecture/.
Signed-off-by: Lu Nelson <ln@hash.ai>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/apps area/infra Relates to version control, CI, CD or IaC (area) area/libs Relates to first-party libraries/crates/packages (area) area/tests New or updated tests type/eng > frontend Owned by the @frontend team

Development

Successfully merging this pull request may close these issues.

1 participant