A Copilot customization framework for Apple platform projects (iOS, iPadOS, macOS, watchOS, tvOS, visionOS). Analyzes your codebase, generates a grounded agent ecosystem, audits the result, and iterates until it passes — all in a single session.
Agent Builder (Conductor)
├── Apple Codebase Analyzer — reads project, inventories existing agents
├── Apple Agent Generator — generates artifacts from scaffold templates
├── Apple Quality Auditor — hard-gates the bundle before delivery
└── Apple Copilot Docs Refresher — kit maintenance only
Conductor + specialist pattern. All behavioral rules, artifact requirements, and bundle shapes live in SKILL.md — the single source of truth. The generator references it via a compliance checklist; the auditor verifies against it.
| Prompt | Use when |
|---|---|
/generate-workflow-agents |
Generate a full workflow kit, or verify and improve an existing ecosystem |
/add-agent |
Add one new agent, or verify a specific existing agent |
/refresh-agents |
Codebase evolved — detect drift and surgically update affected files |
| Component | Count | Examples |
|---|---|---|
| Workspace instructions | 1 | copilot-instructions.md |
| Project context instruction | 1 | <prefix>-project-context.instructions.md |
| Constitution | 1 | Governance rules, Phase -1 gates, evidence standard |
| Agents | 9+ | Orchestrator, BA, Investigator, Implementor, Test Specialist, 4 review agents |
| Skills | 5+ | Delivery workflow, spec pipeline (4 skills), domain-specific |
| Instructions | 3+ | Implementation conventions, test conventions, path-scoped |
| Prompts | 3+ | Primary delivery, spec entry, secondary |
| Templates | 3+ | Spec, plan, tasks |
| Hooks | conditional | When SwiftFormat / SwiftLint / xcodebuild detected |
Review pipeline: Functional → Technical → Platform, with Functional BLOCKER short-circuiting to REJECT. Spec-driven pipeline for non-trivial features; trivial changes skip to implementation.
- Copy
.github/into your Apple platform repository - Open Copilot Chat and run
/generate-workflow-agents - The kit analyzes, generates, and audits automatically
- Generated files use a project-derived prefix (e.g.,
myapp-implementor.agent.md)
Every generated file includes <!-- Generated by Apple Agent Builder Kit --> after YAML frontmatter for maintenance traceability.
- Single source of truth —
SKILL.mddefines all artifact requirements; other files reference, not duplicate - Codebase-first — generated agents match the project's actual stack and conventions
- Evidence standard — every claim backed by code evidence, user confirmation, or labeled
[ASSUMPTION] - Single-session completion — entire workflow completes in one session