Skip to content

docs(governance): define working defaults and sufficient completion scope - #55

Draft
bryansayler wants to merge 4 commits into
mainfrom
codex/working-defaults-20261014
Draft

bryansayler wants to merge 4 commits into
mainfrom
codex/working-defaults-20261014

Conversation

@bryansayler

@bryansayler bryansayler commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Outcome

Add scoped Quirk working defaults and general guidance for selecting sufficient completion scope. The guidance separates thinking breadth, execution increments, and completion commitment. It defines eight situations requiring broader work, preserves explicit small-task limits, and requires unfinished handoffs to explain their stopping reason.

AGENTS links to the shared guidance. Hierarchy, inheritance, evidence, continuity, and source ownership remain explicit. This is a documentation projection with no new concept IDs or execution grants.

Scope

  • AGENTS.md links the working source.
  • docs/governance/WORKING_DEFAULTS.md defines shared defaults and scope-selection guidance.
  • .quirk/evidence/ binds substantive revisions to their bytes and checks.

Use complete-loop implementation, adequate evidence coverage, developed creative experiences, or completed authorized batches when the request requires them. Reflection and play can finish without an action item. Current instructions, scoped authority, and agreed resource limits remain controlling.

Evidence

  • Original base: eb889adf3009951de873890103199600f4aad20f.
  • Original tested subject: eab6b83f06ef910df113f4ccaaa0306dcce8b0ff; receipt: qreceipt.working-defaults.eab6b83f06ef.
  • General scope guidance subject and follow-up receipt are recorded in the branch history and .quirk/evidence/.

Current validation and limits

scripts/validate.sh ran 233 tests: 232 passed and one failed because docs/todos/2026-10-03-workspace-portfolio-plans.md is past its October 17 review date. That file is unchanged from the prior PR head. The script stops at that failure; later stages are not counted as passed.

Separate checks passed: diff whitespace, agent asset validation, and existing evidence receipt validation. Exact-range receipt coverage is checked before pushing. Full repository validation remains blocked by the overdue planning document. No hosted CI, runtime adoption, improved human outcomes, merge, or admission is claimed.

Authority and recovery

The guidance carries forward existing authorization without creating permission for unrelated publication, spending, messages, destructive effects, deployment, or canonical promotion. This remains a draft. Revert the scoped documentation and its follow-up receipt to recover; preserve historical evidence and concurrent changes.

@bryansayler bryansayler changed the title docs(governance): persist scoped Quirk working defaults docs(governance): persist working defaults and complete the intended outcome Oct 30, 2026
@bryansayler bryansayler changed the title docs(governance): persist working defaults and complete the intended outcome docs(governance): define working defaults and sufficient completion scope Oct 30, 2026
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