.claude/global.md
.claude/project.md
.claude/architecture.rules
A professional operating system for building governed AI coding agents: persistent memory, reusable skills, deterministic guardrails, delegated specialists, and installable team plugins.
agent-dev-kit/
├─ CLAUDE.md # project memory
├─ .claude/
│ ├─ skills/ # repeatable expertise
│ ├─ hooks/ # deterministic control
│ ├─ agents/ # specialist subagents
│ ├─ plugins/ # team distribution
│ └─ settings.json # permissions + policies
└─ governance/
├─ review-checklist.md
├─ risk-register.md
└─ release-readiness.mdInspired by the reference visual, upgraded into a board-ready framework for engineering teams, AI studios, agencies, and enterprise product organizations.
Professional agent development is not only speed. It is permissioning, observability, reproducibility, security and team alignment.
Define what each agent can read, edit, execute and publish. Keep destructive actions human-approved.
ReadEditBashMCPAutomatically run formatters, tests, lint, dependency checks and release readiness audits before shipping.
LintTestBuildReviewRecord who invoked which skill, what hooks ran, what files changed and which subagent produced the result.
LogsOwnersApprovals| Need | Best Layer | Reason |
|---|---|---|
| Project conventions | CLAUDE.md | Always available at session start. |
| Repeatable workflow | Skill | Loaded only when useful, easy to share. |
| Non-negotiable rule | Hook | Deterministic shell or policy enforcement. |
| Specialist investigation | Subagent | Separate context with focused tools. |
| Team-wide rollout | Plugin | Bundle and version capabilities across repos. |
Use these as your first corporate baseline, then customize by repository, product line or client account.
--- name: review-pr description: Review a pull request for correctness, security, maintainability and product impact. allowed-tools: Read, Grep, Bash --- You are a senior code reviewer. Inspect the diff, identify risks, verify tests, and produce: 1. Executive summary 2. Blocking issues 3. Non-blocking improvements 4. Test coverage gaps 5. Suggested commit message
--- name: security-analyst description: Use for dependency, secret, permission and attack-surface review before release. tools: Read, Grep, Bash model: fast --- Focus only on security risk. Do not rewrite code unless asked. Return evidence, severity, affected files and remediation steps.
{
"hooks": {
"PreToolUse": [{
"matcher": "Bash",
"hooks": [{"type": "command", "command": "./hooks/pre-tool-use.sh"}]
}],
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{"type": "command", "command": "npm run lint --if-present"}]
}]
}
}# CLAUDE.md ## Product mission Build reliable, secure, fast software with auditable AI assistance. ## Engineering standards - Prefer small, reversible changes. - Explain tradeoffs before major refactors. - Never expose secrets or personal data. - Run tests and report exact commands used. ## Review checklist Security, performance, accessibility, SEO, maintainability, observability.
A practical path from screenshot inspiration to operational agent platform.
Identify repeated prompts, risky commands, specialist tasks and team standards.
Add CLAUDE.md, first three skills, initial hooks and two specialist agents.
Run on one repository. Measure saved time, failure modes and missing permissions.
Bundle as a plugin, document onboarding, version releases and scale to the team.
Research baseline: official Claude Code documentation describes CLAUDE.md customization, skills, hooks, subagents, plugin configuration and SDK/agent capabilities. This page translates those primitives into a corporate implementation framework.