docs(policy): decide Ponytail simplicity posture #125

Merged
pdurlej merged 1 commit from codex/ponytail-simplicity-decision into main 2026-06-23 18:47:59 +02:00
Collaborator

Issue: #123
Value: risk
Effort: small
Lead time: same-day

Summary

  • record D25: Ponytail is inspiration/vocabulary only, not a Patchwarden runtime dependency
  • add an operations decision note for a future default-off simplicity_review reviewer lane
  • keep the proposed lane advisory-only until dogfood calibration proves low false-positive risk

Verification

  • PYTHONPATH=src:. python3 -m unittest discover -s tests
  • PYTHONPATH=src:. python3 -m unittest tests.test_status_html tests.test_cli_status tests.test_docs_module_inventory
  • git diff --check

Refs #123

Issue: #123 Value: risk Effort: small Lead time: same-day ## Summary - record D25: Ponytail is inspiration/vocabulary only, not a Patchwarden runtime dependency - add an operations decision note for a future default-off `simplicity_review` reviewer lane - keep the proposed lane advisory-only until dogfood calibration proves low false-positive risk ## Verification - `PYTHONPATH=src:. python3 -m unittest discover -s tests` - `PYTHONPATH=src:. python3 -m unittest tests.test_status_html tests.test_cli_status tests.test_docs_module_inventory` - `git diff --check` Refs #123
docs: decide ponytail simplicity posture
All checks were successful
fallow-py / fallow-py-advisory (pull_request) Successful in 15s
e160a1d871
Collaborator

🏛️ Architect review (loop) — endorse; one non-blocking egress note

D25 is well-formed and faithful to the core disciplines:

  • Protects stdlib-only: explicitly rejects Node/hooks/MCP/package-install for core (Options C/D rejected).
  • Sensor-not-gate (D20): simplicity_review is default-off, advisory, no approval/merge/blocker authority until 10–20 dogfood PRs prove low false-positive — textbook earn-trust-via-dogfood.
  • Coheres with existing modules: the dependency_risk_sensor / content_slop_sensor / structural_code_gate delineation is accurate and useful.

One non-blocking note (egress posture vs D23): the example TOML sets cloud_review = "allowed". D23 made cloud-review fail-closed (default forbidden; effective posture re-clamped at runtime for sensitive classes), so this isn't a contradiction — D23's review_run guard remains authoritative downstream. But there's a calibration mismatch: the lane is otherwise maximally cautious (default-off, advisory, no authority until dogfood), yet its egress default is allowed. For consistency with both D23's fail-closed stance and D25's own dogfood-first posture, consider starting the lane at cloud_review = "forbidden" and flipping to allowed only once you've confirmed simplicity diffs are safe to egress — i.e., let egress earn trust the same way authority does. At minimum, a one-line note in the decision doc acknowledging the D23 interaction would stop a future implementer inheriting allowed by template inertia.

Not a blocker — mergeable as-is. The note is about template defaults, not correctness. — claude (architect loop)

## 🏛️ Architect review (loop) — ✅ endorse; one non-blocking egress note D25 is well-formed and faithful to the core disciplines: - **Protects stdlib-only**: explicitly rejects Node/hooks/MCP/package-install for core (Options C/D rejected). ✅ - **Sensor-not-gate (D20)**: `simplicity_review` is default-off, advisory, no approval/merge/blocker authority until 10–20 dogfood PRs prove low false-positive — textbook earn-trust-via-dogfood. ✅ - **Coheres with existing modules**: the `dependency_risk_sensor` / `content_slop_sensor` / `structural_code_gate` delineation is accurate and useful. ✅ **One non-blocking note (egress posture vs D23):** the example TOML sets `cloud_review = "allowed"`. D23 made cloud-review **fail-closed** (default `forbidden`; effective posture re-clamped at runtime for sensitive classes), so this isn't a contradiction — D23's `review_run` guard remains authoritative downstream. But there's a *calibration mismatch*: the lane is otherwise maximally cautious (default-off, advisory, no authority until dogfood), yet its egress default is `allowed`. For consistency with both D23's fail-closed stance and D25's own dogfood-first posture, consider starting the lane at `cloud_review = "forbidden"` and flipping to `allowed` only once you've confirmed simplicity diffs are safe to egress — i.e., let egress earn trust the same way authority does. At minimum, a one-line note in the decision doc acknowledging the D23 interaction would stop a future implementer inheriting `allowed` by template inertia. Not a blocker — mergeable as-is. The note is about template defaults, not correctness. — claude (architect loop)
Sign in to join this conversation.
No reviewers
No labels
agent/claude-code
agent/codex
agent/gemini
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
area:business-model
area:competitive
area:discovery
area:forgejo
area:metrics
area:product-strategy
area:v0-core
cagan-grade-approved
client:platform
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
kind:artifact
kind:decision
kind:dogfood
kind:epic
kind:implementation
kind:research
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
priority:p0
priority:p1
priority:p2
priority:p3
ready-for-agent
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:blocked-on-discovery
status:cagan-grade-review-pending
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:needs-operator-decision
status:operator-needed
status:parked
tier:0-anchor
tier:0-platform-substrate
tier:1-core
tier:1-iskra-value-layer
tier:2-supporting
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
wave:1-foundation
wave:2-positioning
wave:3-validation
wave:4-economics
wave:5-operating
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/patchwarden!125
No description provided.