Skip to content

docs(cybernetic-ecology): add boundary policy narrative page and README pointer - #175

Merged
coreytshaffer merged 1 commit into
mainfrom
claude/cybernetic-ecology-boundary-docs
Aug 13, 2026
Merged

coreytshaffer merged 1 commit into
mainfrom
claude/cybernetic-ecology-boundary-docs

Conversation

@coreytshaffer

Copy link
Copy Markdown
Owner

Summary

  • Two-path documentation slice, based on current main (938e9f26f917b4b829a64689be3117e791208f0c, the invariant-checklist citation fix), under explicit implementation authority scoped to exactly these paths.
  • New file docs/operations/cybernetic-ecology-boundary.md: an explanatory narrative page for TriageCore's Cybernetic Ecology boundary policy. Covers purpose/source of truth (policies/cybernetic_ecology_boundary.yaml, configured via triagecore.toml), current integration (the governed tc run path, run_plan's coarse configured_or_hardcoded preview field, and the Worker Council's escalation-packet consumer), fallback semantics (the hardcoded floor is narrower than the YAML — tribal/cultural terms plus only water intake/sewer lift, missing the YAML's regulatory and coordinate-regex rules), decision semantics (human_only/codex are recommendations, not automatic actions; the steward-specific handoff_required behavior is explicitly not generalized to every human_review_required field elsewhere), non-claims (explicitly stating this policy carries no tribal endorsement, consultation, or representation unless separately established), and verification pointers to the real test file and policy YAML.
  • One discoverability bullet added to README's existing ### Safety Invariants list, linking to the new page.
  • Investigation conclusion preserved: this subsystem is real, deliberately built (docs/backlog.md Story 11.3), tested, and currently active — this slice documents existing behavior, it does not redesign, rename, or alter any of it.

Test plan

  • Confirmed the diff touches exactly two paths: docs/operations/cybernetic-ecology-boundary.md (new) and README.md (one bullet).
  • Confirmed all explicitly-excluded paths are untouched: triage_core/project_steward.py, triage_core/orchestration.py, triage_core/client.py, triage_core/run_plan.py, triagecore.toml, policies/cybernetic_ecology_boundary.yaml, AGENTS.md, docs/architecture/current_system_architecture.md, docs/current_backlog.md, docs/change/change_log.md, tests/test_project_steward_firewall.py.
  • Confirmed the two verification links resolve with the literal repository-relative destinations ../../tests/test_project_steward_firewall.py and ../../policies/cybernetic_ecology_boundary.yaml in the file source.
  • Confirmed the primary codex/agents-governance-separation checkout remains in its original pre-existing dirty state throughout.
  • Branch created fresh from current main, verified unchanged immediately before branching.
  • git diff --check clean (exit 0).

No test-suite run — documentation-only change, no code/config/policy touched.

🤖 Generated with Claude Code

…ME pointer

Two-path documentation slice, based on current main
(938e9f2), under explicit
implementation authority scoped to exactly these paths.

Adds docs/operations/cybernetic-ecology-boundary.md, an explanatory
narrative page covering purpose/source of truth, current integration
(tc run, run_plan preview, the Worker Council escalation-packet
consumer), fallback semantics (the hardcoded floor is narrower than
the YAML, not a duplicate of it), decision semantics (human_only/codex
are recommendations, not automatic actions; steward-triggered
handoff_required is not generalized to every human_review_required
field), non-claims (explicitly including that this policy carries no
tribal endorsement, consultation, or representation), and verification
pointers to the real test file and policy YAML.

Adds one discoverability bullet to README's existing Safety Invariants
list, linking to the new page.

Makes the existing, already-implemented and already-tested boundary
policy discoverable; does not redesign, rename, or alter any of its
runtime behavior. project_steward.py, orchestration.py, client.py,
run_plan.py, triagecore.toml, the YAML policy, tests, AGENTS.md,
current_system_architecture.md, and backlog/change-log records are
all untouched.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Deploy Preview for poetic-quokka-0fd859 ready!

Name Link
🔨 Latest commit f334e56
🔍 Latest deploy log https://app.netlify.com/projects/poetic-quokka-0fd859/deploys/6a7d10bd37469e00089e3204
😎 Deploy Preview https://deploy-preview-175--poetic-quokka-0fd859.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coreytshaffer
coreytshaffer merged commit d3462a5 into main Aug 13, 2026
8 checks 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.

1 participant