Skip to content

docs: make agent decisions autonomous with a self-contained protocol - #118

Merged
dapi merged 8 commits into
mainfrom
docs/issue-117-autonomy-fpf
Aug 13, 2026
Merged

docs: make agent decisions autonomous with a self-contained protocol#118
dapi merged 8 commits into
mainfrom
docs/issue-117-autonomy-fpf

Conversation

@dapi

@dapi dapi commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Closes #117

What changed

  • replaced the implicit external FPF dependency with a self-contained Structured Decision Protocol;
  • documented First Principles Framework (FPF) only as an optional source of deeper analysis, not a required skill or specification;
  • made complexity and competing approaches inputs to the protocol rather than automatic Human Gates;
  • added the canonical proceed | bounded_probe | escalate outcomes and autonomous tie-breakers;
  • separated decision authority, durable decision records, and permission to execute externally effective actions;
  • restricted Human Routing to missing authority or value judgments and risks that cannot be contained;
  • kept P0 route classification read-only and routed experiments or broad evidence collection through Research Flow;
  • aligned validation profiles so preparation remains autonomous and specific task/project-policy preauthorization can satisfy an applicable deployment approval;
  • synchronized Bug Fix, Feature, Epic, routing, and epic decision-log governance.

Why

The previous policy mixed difficult reasoning with permission gates. The first revision also named FPF without defining whether downstream agents needed an external specification or skill. The template now contains the complete executable decision contract while preserving real production, security, compliance, communication, and scope boundaries.

Review fixes included

  • removed the circular bounded_probe-before-routing path;
  • reconciled deployment approvals with the canonical Human Gate;
  • added direct governance dependencies where the protocol is applied;
  • removed undefined FPF requirements from agent-facing governance documents.

Validation

  • ruby tools/validate-priming-manifests.rb template/memory-bank
  • memory-bank-cli lint --scope-root template/memory-bank --entrypoint template/memory-bank/README.md
  • memory-bank-cli doctor --profile template
  • git diff origin/main...HEAD --check

All checks pass on the current origin/main base.

@dapi dapi changed the title docs: make agent decisions autonomous by default through FPF docs: make agent decisions autonomous with a self-contained protocol Aug 13, 2026
@dapi
dapi marked this pull request as ready for review August 13, 2026 23:08
@dapi
dapi merged commit e8060f5 into main Aug 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: make agent decisions autonomous through a structured protocol

1 participant