Skip to content

UK Government overlay extraction (v6.0.0): jurisdiction-neutral core#557

Open
tractorjuice wants to merge 11 commits into
mainfrom
uk-gov-overlay-extraction
Open

UK Government overlay extraction (v6.0.0): jurisdiction-neutral core#557
tractorjuice wants to merge 11 commits into
mainfrom
uk-gov-overlay-extraction

Conversation

@tractorjuice

Copy link
Copy Markdown
Owner

Summary

Extracts all UK-government-specific functionality out of the arckit core into two new officially-maintained overlays, making the core genuinely jurisdiction-neutral and symmetric with every other jurisdiction. Breaking change, targeted at v6.0.0.

  • Core neutralised: 71 to 56 commands. risk and sobc stay in core but are now framework-aware via ${user_config.governance_framework} (HM Treasury Orange/Green Book under UK Gov, ISO 31000 / generic 5-case under Generic).
  • New arckit-uk (official, default-on): 13 commands (uk- prefix) covering TCoP, Secure by Design, DPIA, AI Playbook, ATRS, Service Standard, G-Cloud/DOS, gov-code reuse, grants. Carries the 8 gov/grants agents (renamed arckit-uk-*) and the govreposcrape MCP. Recipe uk-saas.
  • New arckit-uk-mod (official, default-off, depends on arckit-uk): 2 defence commands (uk-mod-secure, uk-mod-jsp-936). Recipe uk-mod-sovereign.
  • Marketplace now 13 plugins; the 71-command official baseline spans 3 official plugins (56 + 13 + 2). Community 76, total 147 unchanged.

What else changed (the ripple)

  • Recommendation engine is regime-aware: hooks/regime.mjs ukGov() reads CLAUDE_PLUGIN_OPTION_GOVERNANCE_FRAMEWORK; graph-inject, graph-rollups, analyze/health/impact, and the workflow-path skills gate UK suggestions on it. SECD doc-type tagged regime: 'UK'.
  • UAE + AU recipes decoupled with no UK dependency (UAE used its native uae-pdpl/uae-ias/uae-ai-charter; AU swapped ai-playbook for native au-ai-assurance).
  • uk-saas moved to arckit-uk; core gets a new neutral baseline default recipe.
  • NHS + Finance overlays re-parented onto arckit-uk (fixes the prior inconsistency where they hung off core).
  • ~260 cross-references re-pointed; extensions regenerated; overlay command namespace errors fixed across the docs; docs/MIGRATION-v6.md added with the 15 old-to-new mappings.

Design and plan: docs/superpowers/specs/2026-06-01-uk-gov-overlay-extraction-design.md, docs/superpowers/plans/2026-06-01-uk-gov-overlay-extraction.md.

Notes for release

  • Version is deliberately left at 5.8.0 on the branch. Run bump-version.sh 6.0.0 as part of the normal post-merge release flow (it auto-discovers the two new plugins and pins all inter-plugin deps to =6.0.0).
  • Open item: .arckit/templates/story-template.md had pre-existing uncommitted edits and is now stale vs the re-pointed arckit-claude/templates/story-template.md. Reconcile before release.
  • Release gate: smoke-test that defaultEnabled: true actually auto-enables arckit-uk on a fresh marketplace install.
  • scripts/migrate-uk-refs.sh is kept for the separate 27 test-repo migration (post-release).

Test plan

  • python scripts/check_references.py (343 files, no broken refs)
  • node scripts/tests/test-regime-registration.mjs (9 regimes)
  • node scripts/tests/test-doc-types-dual-registration.mjs (132 codes)
  • node tests/plugin/test_graph_inject_regime.mjs (regime gating both ways)
  • npx markdownlint-cli2 clean on changed docs
  • python scripts/converter.py regenerates extensions with uk-* commands
  • claude plugin tag <p> --dry-run validates all 13 plugins (new ones create cleanly)
  • Core has zero UK-specific commands; acceptance criteria in spec section 13 met
  • Smoke-test defaultEnabled: true out-of-box behaviour on a fresh install (release gate)

🤖 Generated with Claude Code

tractorjuice and others added 11 commits June 1, 2026 17:04
Extract the UK-specific surface out of the neutral core into two new
official overlays (arckit-uk, arckit-uk-mod), making core jurisdiction-
neutral and symmetric with the other overlays.

Captures seven agreed decisions (full extraction, defence split, uk-
prefix, default-on arckit-uk, UAE/AU decoupling, uk-saas relocation +
neutral baseline recipe, regime-aware recommendation engine) and the
verified blast radius (Tier 1 functional recipe breaks, ~260 Tier 2
cosmetic references, NHS/Finance re-parenting).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Phased plan (0-6) for the in-repo refactor: scaffold arckit-uk +
arckit-uk-mod, move 15 commands/templates/agents/MCP, relocate + re-point
recipes, neutralise risk/sobc, regime-aware recommendation engine via
sibling-plugin detection, re-point ~260 references, doc sweep, v6.0.0
bump. Test-repo migration deferred to a follow-on plan.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…via CLAUDE_PLUGIN_OPTION env var

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… prep)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… overlays (no edit needed)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rckit-uk-mod [WIP]

Phase 1 of UK Gov overlay extraction (v6.0.0). Moves 13 arckit-uk
commands + 2 arckit-uk-mod commands, 15 templates, 8 agents, gov-reuse
and grants schemas/rubrics into the new plugin skeletons. Removes
govreposcrape MCP from core arckit-claude. Adds migrate-uk-refs.sh for
Phase 4. ~260 dangling refs in core/other plugins are expected and fixed
in later phases.
…decouple UAE/AU [WIP]

- git mv uk-saas → arckit-uk/recipes/, uk-mod-sovereign → arckit-uk-mod/recipes/,
  uk-nhs-clinical-safety → arckit-uk-nhs/recipes/, uk-fs-payments → arckit-uk-finance/recipes/
- Re-point all 6 relocated UK skill refs (tcop/secure/dpia/ai-playbook/atrs/service-assessment/
  gov-reuse/mod-secure/jsp-936) to arckit-uk:/arckit-uk-mod: namespaces in each recipe
- Create arckit-claude/skills/arckit-build/recipes/baseline.yaml — neutral governance baseline
  (32 targets, no jurisdiction-specific compliance; TCOP/SBD/DPIA/AIP/SVCASS/GOV_REUSE removed)
- Switch arckit-build SKILL.md default recipe uk-saas → baseline; update built-in recipes table,
  schema reference, step 3, /goal example, and v0.5 inheritance example
- UAE: remove TCOP/SBD/DPIA/AIP/ATRS target blocks from both UAE recipes; fix UAE_IAS deps
  (drop SBD); fix TRACE deps (drop all 5 removed IDs); remove AIP/ATRS optional_targets entries
- AU: replace arckit:ai-playbook with arckit-au:au-ai-assurance (type AIPB → AUAIA); update
  swap-comment to drop arckit: prefixed UK names
…ine [WIP]

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…tag SECD regime UK [WIP]

Phase 4 of UK Gov overlay extraction: sweep 102 files across arckit-claude,
arckit-fr, arckit-eu, arckit-at, arckit-us, arckit-au, arckit-uk-nhs, and
arckit-uk-finance with both slash (/arckit:<cmd>) and no-slash (arckit.<cmd>)
sed patterns, replacing all 15 moved command refs with their new plugin-scoped
names (arckit-uk:uk-* and arckit-uk-mod:uk-mod-*). Also tags SECD with
regime: 'UK' in doc-types.mjs so graph-inject groups it under the UK regime.
Completeness gate (Step 3) is empty. No double-prefixes or malformed mod names.
.arckit/ tree untouched.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…K handoffs; regenerate extensions (green)

- arckit-uk-nhs + arckit-uk-finance: add arckit-uk dep (=5.8.0) alongside existing arckit dep
- arckit-claude/commands/{datascout,requirements}: remove dpia handoff (moved to arckit-uk)
- arckit-claude/commands/risk: remove secure handoff (moved to arckit-uk)
- arckit-claude/commands/sow: remove dos handoff (moved to arckit-uk)
- Regenerate arckit-{codex,opencode,gemini,copilot,paperclip} via converter.py (146 commands each)
- All validators green: check_references (343 files, 0 broken), test-regime-registration (9 regimes), test-doc-types-dual-registration (132 codes), markdownlint (0 errors)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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