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 27, 2026 5:56pm
petrinaut Ready Ready Preview Aug 27, 2026 5:56pm
petrinaut-docs Ready Ready Preview Aug 27, 2026 5:56pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
hashdotdesign-tokens Ignored Ignored Preview Aug 27, 2026 5:56pm

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-process guidance only; no runtime or merge-gate code changes in this diff.

Overview
Replaces Brunch’s multi-protocol agent operating model (steering, arc-close, document index, spec ledger, wayfinding, partition worktrees, legibility, and related skills) with a mission-first charter centered on AGENTS.md, new MISSION.md, and slimmed tracker docs.

AGENTS.md now states three execution laws, a six-field mission contract (imperative, throughline, proof, constraints, fog-line, stop/reorient), correctives, and an explicit rule that specs/ADRs/evidence are reference hypotheses, not build obligations. apps/brunch-agent/AGENTS.md points agents at MISSION.md first and scopes the app to Flue plus packages the current mission needs.

MISSION.md defines Mission 1: prove Petrinaut ↔ plain Flue chat end-to-end (AI SDK transport only, no harness/plugins on the active path, Flue history authoritative) before re-adding elicitation semantics.

Removed or retired: docs/INDEX.md, docs/control/SPEC-LEDGER.md, most of docs/agents/* (steering, arc-close, documentation, legibility, domain, partition-worktrees, triage-labels, posture), and arc-close skill wrappers. CONTEXT.md and README.md are trimmed; docs/adr/README.md labels ADRs as historical. git-workflow, issue-tracker, and issue-writing are rewritten for one issue / one branch / one PR and inbox-style Linear posture without bulk reconciliation.

Reviewed by Cursor Bugbot for commit b06ac00. 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