Skip to content

feat(setup): add --no-overrides one-shot defaults switch#929

Open
justinmclean wants to merge 2 commits into
apache:mainfrom
justinmclean:override-bypass-one-shot2
Open

feat(setup): add --no-overrides one-shot defaults switch#929
justinmclean wants to merge 2 commits into
apache:mainfrom
justinmclean:override-bypass-one-shot2

Conversation

@justinmclean

@justinmclean justinmclean commented Jul 27, 2026

Copy link
Copy Markdown
Member

Summary

Implements acceptance criterion 6 of specs/adoption-and-setup.md:
a per-invocation --no-overrides flag that runs any framework skill
against framework defaults for that single invocation, ignoring both
override surfaces without modifying or deleting them. The safety
baseline (confidentiality, privacy, security) still applies.

Adds the protocol to docs/setup/agentic-overrides.md under a new
"One-shot defaults run" section, lists the flag in the setup SKILL.md
Inputs table, and ships a three-case eval suite exercising:

  • flag present + override exists → skip-overrides
  • flag present + no override → skip-overrides
  • flag absent + override exists → apply-overrides (baseline)

Generated-by: Claude (claude-sonnet-4-6)

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other:

Test plan

  • [X ] prek run --all-files passes
  • For Python packages touched: uv run pytest / ruff check / mypy passes
  • For Groovy bridges touched: command-line invocation tested end-to-end
  • For skill changes: eval suite passes for the affected skill
    (PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
    (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)
  • Other:

Implements acceptance criterion 6 of specs/adoption-and-setup.md:
a per-invocation --no-overrides flag that runs any framework skill
against framework defaults for that single invocation, ignoring both
override surfaces without modifying or deleting them.  The safety
baseline (confidentiality, privacy, security) still applies.

Adds the protocol to docs/setup/agentic-overrides.md under a new
"One-shot defaults run" section, lists the flag in the setup SKILL.md
Inputs table, and ships a three-case eval suite exercising:
  - flag present + override exists → skip-overrides
  - flag present + no override → skip-overrides
  - flag absent + override exists → apply-overrides (baseline)

Note: this branch is based on main and is independent of the
in-flight magpie-local-convention branch.  When that branch merges
(adding .apache-magpie-local/ as a second override surface), the
"One-shot defaults run" prose here will need a minor update to say
"skip steps 1–5" instead of "1–3" and to mention .apache-magpie-local/
alongside .apache-magpie-overrides/.  The merge conflict is shallow
and localised to the one paragraph.

Generated-by: Claude (claude-sonnet-4-6)
@justinmclean justinmclean self-assigned this Jul 27, 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