No description
Find a file
Cole Medin 3c61a5b5ee feat(hooks): add the baseline hooks pair - the pack shipped none
The pack's README instructs cp -r .claude into your own repo, but there
was no .claude/hooks/ at all - not even the always-on safety pair the
rest of the AI Layer material assumes. Adds two generic, codebase-
agnostic hooks: PreToolUse blocks reading real secrets (the env file and
the other usual homes for one) plus rm -rf; PostToolUse logs every tool
call for an audit trail. Plus settings.json.example to wire them in.

Deliberately does not ship anything more specific (a completion gate, an
artifact hand-off between skills) - those need to know your commands and
paths, which a generic starter pack can't guess. The new hooks README
points at describing the guarantee to your agent instead of copying a
file that wouldn't fit your stack anyway.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-24 07:57:29 -05:00
.claude feat(hooks): add the baseline hooks pair - the pack shipped none 2026-08-24 07:57:29 -05:00
.github/workflows feat: ship the PR review workflow, and publish /spec output to Confluence 2026-07-29 11:49:32 -05:00
diagrams docs: add the AI Layer at-a-glance diagram, drop em dashes from the README 2026-07-28 14:53:01 -05:00
.gitignore AI Layer Starter Pack — reusable agentic-engineering skills 2026-05-21 15:01:10 -05:00
.mcp.json Ship .mcp.json (Atlassian MCP) with the pack 2026-05-24 13:15:41 -05:00
README.md feat(hooks): add the baseline hooks pair - the pack shipped none 2026-08-24 07:57:29 -05:00

AI Layer Starter Pack

The reusable AI Layer for agentic engineering - the skills, agents, and reference docs you install once into any codebase. This is the generic foundation used in the free "AI-Native Engineering Org" workshop: you install this, then derive the rest from your own code and wire it into your team's process.

Install once → customize from your codebase. The pack is intentionally generic. The codebase-specific part of the AI Layer - your CLAUDE.md rules and on-demand .claude/context/ modules - you generate with the /create-rules skill below, reading your actual code. That's the whole idea: the AI Layer is your team's own knowledge and process, encoded.

Install

# 1. Clone this pack
git clone https://github.com/coleam00/ai-native-starter-pack
# 2. Copy the AI Layer into your project (skills/agents/references + the Atlassian .mcp.json)
cp -r ai-native-starter-pack/.claude <your-repo>/.claude
cp ai-native-starter-pack/.mcp.json <your-repo>/.mcp.json
# 2a. Optional: turn on the two baseline hooks (env-file / rm -rf guardrail + an
#     audit-log trail). Commit the resulting settings.json so your whole team
#     inherits the guarantee.
cp ai-native-starter-pack/.claude/settings.json.example <your-repo>/.claude/settings.json
# 2b. Optional: the PR review workflow (needs a CLAUDE_CODE_OAUTH_TOKEN repo secret)
cp -r ai-native-starter-pack/.github <your-repo>/.github
# 3. In your repo, derive your rules from your real code:
#    run  /create-rules   → writes CLAUDE.md + .claude/context/ (cited to your code)
# 4. Wire external context: the pack ships a .mcp.json for the Atlassian MCP (Jira +
#    Confluence) - edit/replace it for your stack - then
#    run  /prime <jira-keys> <confluence-page-ids>

(Git submodule also works if you want to track upstream updates.)

What's in here

Context & priming

  • prime - load codebase context; optionally pull Jira issues + Confluence pages first (prime [jira-keys] [confluence-page-ids], via the Atlassian MCP)
  • prime-backend / prime-frontend - focused priming for one side of a full-stack repo

Build the layer (codebase-specific, derived)

  • create-rules - derive CLAUDE.md + .claude/context/ from your real codebase (Brownfield Type A). The one you run first per project.
  • create-prd - greenfield: turn an idea into a PRD

The PIV loop (Plan → Implement → Validate - the core methodology)

  • plan-feature - Plan: a context-rich, one-pass implementation plan
  • execute - Implement: build strictly from the approved plan
  • validate - Validate: run the project's tests / type-check / lint / build before a PR
  • commit - structured commit at the end of a loop

Review

  • code-review (+ the code-reviewer agent) - first-pass review on a diff/PR
  • code-review-fix - apply review findings

System evolution (improve the AI Layer over time)

  • rca - root-cause a bug and propose a rule + regression test so the class can't recur
  • system-review - diff intent vs outcome; surface rules/context to tighten
  • execution-report - capture what a loop actually did vs the plan

Slicing & parallelism

  • spec - slice an epic / PRD into PIV-sized tickets with a dependency graph
  • new-worktrees / merge-worktrees - run independent tickets in parallel git worktrees

Examples / extras

  • end-to-end-feature, implement-fix, ast-grep, init-project - additional reusable skills

Agents: code-reviewer, system-reviewer, research-agent References (universal best-practice): architecture-patterns, backend-api-best-practices, frontend-component-best-practices, vertical-slice-architecture MCP wiring: .mcp.json - ships pointing at the Atlassian MCP (Jira + Confluence) so prime can pull tickets + linked spec pages out of the box; edit it to point at your own stack. Hooks: .claude/hooks/ - two generic, always-on guardrails (block reads of real secrets + rm -rf; log every tool call) plus settings.json.example to turn them on. See .claude/hooks/README.md for anything specific to your own workflow (a completion gate, an artifact hand-off between skills) - those have to be described to your agent, not copied from a generic pack.

The diagrams from the workshop

The maps from the live session, free to reuse.

The AI Layer at a glance

What actually goes in the layer: global rules and on-demand context, skills and agents, then the wiring (MCP, hooks, LSP) that connects the agent to the tools you already use.

The AI Layer at a glance

The same epic, two systems

The whole workshop in one frame. Same Confluence epic down two paths: one where the team burns its time cleaning up slop, one where it ships. The only difference is the AI Layer.

Two-lane SDLC map

The AI-Native SDLC, in detail

The same flow with the tool zones (Confluence, Jira, your IDE, GitHub), the artifact produced at each step, and the bug-to-rule loop that feeds the layer back into the next ticket.

The AI-Native SDLC in detail

Relationship to the Dynamous Agentic Coding course

This is a focused subset for the 2-hour workshop - enough to build the AI Layer and run the PIV loop + system evolution end-to-end. The full Dynamous Agentic Coding course goes much deeper across many more modules, commands, subagents, and the complete validation, remote-coding, MCP, and Archon workflows. This pack is the on-ramp.

License / use

Free to use. Built for attendees of the "AI-Native Engineering Org Transformation" workshop, but you don't need to have been there. Clone it, install it, make it yours.