Skip to content

docs: fix envoy scope misstatements and add scope boundary (Stories 82.1, 82.2)#929

Merged
arcaven merged 2 commits intomainfrom
work/kind-bear
Apr 3, 2026
Merged

docs: fix envoy scope misstatements and add scope boundary (Stories 82.1, 82.2)#929
arcaven merged 2 commits intomainfrom
work/kind-bear

Conversation

@arcavenai
Copy link
Copy Markdown
Contributor

Summary

  • Story 82.1 (P1): Fix envoy scope misstatements in agents/supervisor.md and docs/architecture/governance-model.md
    • supervisor.md:69: "Envoy runs the BMAD pipeline" → "Envoy runs three-layer triage screening"
    • governance-model.md:38: "Welcome, triage, create stories" → "Welcome, triage, label, relay; cannot make scope decisions or create stories"
  • Story 82.2 (P2): Add ## SCOPE BOUNDARY callout section to agents/envoy.md after "Your Mission", reinforcing that envoy is issues-board only

All changes are consistent with envoy.md's existing "What You Do NOT Do" (line 279) and "CANNOT (Forbidden)" (line 304) sections.

Opportunities

  • docs/remote-collaboration.md:238 also references envoy running "standard BMAD pipeline" — another instance of the same misstatement, not in scope for these stories

Test plan

  • Grep verification: no remaining misstatements that envoy "creates stories" or "runs BMAD pipeline" in authoritative docs
  • envoy.md "What You Do NOT Do" section unchanged (supplements, not replaces)
  • Human review required (CODEOWNERS-protected files: agents/, docs/architecture/)

Provenance: L3

…1, 82.2)

- supervisor.md: Replace "Envoy runs BMAD pipeline" with accurate
  "three-layer triage screening" description
- governance-model.md: Remove incorrect "create stories" from envoy
  authority, replace with "label, relay"
- envoy.md: Add SCOPE BOUNDARY section after Your Mission to reinforce
  operational limits early in context window
- Update both story files to Done

Provenance: L3
@arcavenai arcavenai requested a review from arcaven as a code owner April 2, 2026 23:48
@arcavenai arcavenai added the provenance.L3 AI-autonomous: AI works independently, human reviews label Apr 2, 2026
@arcavenai arcavenai added status.needs-human Blocked on human action or decision type.docs Improvements or additions to documentation agent.worker Worker agent actively implementing scope.in-scope Fits current roadmap labels Apr 2, 2026
@arcaven arcaven merged commit 109d960 into main Apr 3, 2026
10 checks passed
@arcaven arcaven deleted the work/kind-bear branch April 3, 2026 00:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent.worker Worker agent actively implementing provenance.L3 AI-autonomous: AI works independently, human reviews scope.in-scope Fits current roadmap status.needs-human Blocked on human action or decision type.docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants