Add coding-agent skillpack generation for local-first onboarding

[bmdhodl]

PR Draft

Title

Add coding-agent skillpack generation for local-first AgentGuard onboarding

Summary

• add agentguard skillpack so developers and coding agents can generate repo-local .agentguard.json defaults plus instruction files for Codex, Claude Code, GitHub Copilot, and Cursor
• keep the generated flow aligned with the existing local-first proof path: agentguard doctor, agentguard quickstart --framework raw --write, local starter run, local report
• update onboarding docs so the skillpack flow becomes the primary way to materialize coding-agent instructions instead of copying long snippets by hand

Scope

• new core SDK module: sdk/agentguard/skillpack.py
• CLI wiring in sdk/agentguard/cli.py
• tests in sdk/tests/test_skillpack.py and sdk/tests/test_architecture.py
• onboarding docs in README.md, docs/guides/getting-started.md, docs/guides/coding-agents.md, and docs/guides/coding-agent-safety-pack.md
• generated sdk/PYPI_README.md
• proof artifacts under proof/skillpack/

Non-goals

• no dashboard work
• no hosted settings in generated files
• no new runtime dependencies
• no speculative agent integrations beyond Codex, Claude Code, Copilot, and Cursor

Proof

• python -m ruff check sdk/agentguard/skillpack.py sdk/agentguard/cli.py sdk/tests/test_skillpack.py sdk/tests/test_architecture.py
• python -m pytest sdk/tests/test_skillpack.py sdk/tests/test_quickstart.py sdk/tests/test_architecture.py -v
• python scripts/sdk_preflight.py
• python -m pytest sdk/tests -v --cov=agentguard --cov-report=term-missing --cov-fail-under=80
• python scripts/sdk_release_guard.py
• python -m bandit -r sdk/agentguard -s B101,B110,B112,B311 -q
• proof files:
  • proof/skillpack/write-output.txt
  • proof/skillpack/claude-output.txt
  • proof/skillpack/codex-write-output.txt
  • generated pack under proof/skillpack/all/

Operator note

• local validation pinned PYTHONPATH=<repo>/sdk because this machine has another editable agentguard47 install that can shadow branch code

[Copilot]

Pull request overview

Adds a new agentguard skillpack CLI workflow to generate repo-local AgentGuard defaults plus coding-agent instruction files, making local-first onboarding more turnkey and updating docs/release artifacts to match.

Changes:

• Introduces sdk/agentguard/skillpack.py and wires it into the CLI as agentguard skillpack (print + JSON + --write).
• Adds unit tests and updates architecture allowlist for the new module.
• Updates onboarding docs / PyPI README / changelog and includes proof artifacts for the generated outputs.

Reviewed changes

Copilot reviewed 20 out of 23 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
sdk/agentguard/skillpack.py	New generator for .agentguard.json + agent-specific instruction files; supports JSON + write-to-disk.
sdk/agentguard/cli.py	Adds skillpack subcommand and CLI flags; imports new module.
sdk/tests/test_skillpack.py	New tests covering JSON output, target selection, write behavior, overwrite refusal, and CLI wiring.
sdk/tests/test_architecture.py	Adds skillpack.py to the architecture module allowlist.
README.md	Documents the new agentguard skillpack --write onboarding flow.
docs/guides/getting-started.md	Mentions skillpack as a way to materialize repo-local instruction files.
docs/guides/coding-agents.md	Adds skillpack usage as the preferred way to generate instruction files.
docs/guides/coding-agent-safety-pack.md	Updates safety-pack guide to reference/generated via skillpack and updates verification commands.
sdk/PYPI_README.md	Adds skillpack usage to the packaged README.
CHANGELOG.md	Notes the new skillpack feature and doc updates under Unreleased.
proof/skillpack/write-output.txt	Captures example output for skillpack --write.
proof/skillpack/codex-write-output.txt	Captures example output for codex-targeted write.
proof/skillpack/claude-output.txt	Captures example output for claude-code target.
proof/skillpack/all/.agentguard.json	Example generated repo config for “all” target.
proof/skillpack/all/AGENTS.md	Example generated Codex instructions.
proof/skillpack/all/CLAUDE.md	Example generated Claude Code instructions.
proof/skillpack/all/.github/copilot-instructions.md	Example generated Copilot instructions.
proof/skillpack/all/.cursor/rules/agentguard.mdc	Example generated Cursor rule file.
proof/skillpack/codex/.agentguard.json	Example generated repo config for codex target.
proof/skillpack/codex/AGENTS.md	Example generated Codex instructions for codex target.
PR_DRAFT.md	Updates the draft PR narrative to reflect the skillpack work.
ops/03-ROADMAP_NOW_NEXT_LATER.md	Marks “Coding-agent skillpack generation” as Done.
MORNING_REPORT.md	Updates status/validation notes to reflect the skillpack shipment.