• PR adds new community overlay (e.g.

  au-federal

  ,

  ca-federal-fitaa

  , future

  au-vic-*

  )
• PR extends an existing overlay (new

  xx-*

  command, new recipe target)
• PR ships a new build recipe alongside

  xx-*

  commands
• Author is contributor (not maintainer) and PR is large (10+ files, 5K+ lines)

scripts/bash/generate-document-id.sh <TYPECODE> --filename

PROJECT_ID DOC_TYPE [VERSION] [OPTIONS]

grep -n "generate-document-id.sh" arckit-<prefix>/commands/<prefix>-*.md | grep -v "<PROJECT_ID>\|{P}"

arckit-ca/commands/ca-pia.md:32

scripts/bash/generate-document-id.sh <PROJECT_ID> PIA --filename

uae-*

xx-*

• Frontmatter:

  description

  present. No invalid fields (

  name:

  ,

  color:

  ,

  permissionMode:

  ,

  tools:

  are NOT valid plugin command frontmatter —

  name:

  in particular is a common contributor mistake; filename is source of truth).

• $ARGUMENTS

  placeholder present in body —

  tests/plugin/test_commands_structure.py::test_arguments_placeholder_present

  checks this. Existing

  ca-*

  /

  uae-*

  commands fail this test (32 known failures); new overlay commands should pass.

• create-project.sh

  lookup — only required for project-bootstrapping commands (

  principles

  ,

  requirements

  , the first command someone runs). Most overlay commands assume the project already exists and skip this; that matches the FR/AT/EU/CA precedent. Not a defect when absent.

• generate-document-id.sh

  invoked correctly (B3).

• <!-- DOC-CONTROL-HEADER -->

  resolution instruction (B2 — should override classification when not UK/UAE).
• Write tool used to save artefact (32K output token limit otherwise).
• Handoffs: every

  handoffs.command

  value resolves to a real file in

  arckit-claude/commands/

  . Common bug: pluralisation (

  risks

  vs

  risk

  ); deps on commands shipping in sibling PRs. Validation needs YAML parsing (handoffs are nested under YAML frontmatter — raw grep misses), e.g.:
  python

  import yaml, glob, pathlib
  cmds = {pathlib.Path(p).stem for p in glob.glob('arckit-claude/commands/*.md')}
  for f in glob.glob('arckit-<prefix>/commands/<prefix>-*.md'):
      fm = yaml.safe_load(open(f).read().split('---')[1])
      for h in (fm or {}).get('handoffs', []):
          if h['command'] not in cmds: print(f, '→', h['command'])

• Template path references

  ${CLAUDE_PLUGIN_ROOT}/templates/<name>-template.md

  with

  templates-custom

  then

  .arckit/templates/

  fallback.
• Per-template footer:

  **Generated by**

  ,

  **Generated on**

  ,

  **ArcKit Version**

  ,

  **Project**

  ,

  **Model**

  all present.

• Run

  pytest tests/plugin/

  and check for new failures specific to this PR's files.
• If PR adds

  .github/workflows/*

  (first-time CI), run the full suite locally and report pre-existing failure count to the author.
• If PR adds a recipe-validation test, verify it codifies the headline scorecard claims (target count, deps, doc-types registration, regime registration, pages allow-list).

• PR #441 (au-federal, 2026-05-05) — canonical fixture for B1–B4. Exhibited all four (template heading, classification override, doc-id invocation, converter drift) plus 6 important issues. Posted review: https://github.com/tractorjuice/arc-kit/pull/441#issuecomment-4386152326
• PR #432 (ca-federal-fitaa, merged 2026-05-05) — fixture for B5 (regime registration). Shipped 12 doc-types with

  regime: 'CA'

  while

  'CA'

  was missing from the

  REGIMES

  array. Bug only surfaced retroactively in #441. Validates the skill against an already-merged overlay where B1–B4 all PASS but a different blocker class exists.