// architecture
How It Works
Every request you make goes through Boss— the routing agent that decides which specialists to delegate to based on what you're trying to do.
// boss.routes
The Three Scenarios
Boss analyses your message and routes it to one of three tracks — each with a different team composition and workflow.
// scenario 01
Build
when: new feature / bug fix
Boss hands off to Worker for full-stack implementation, then Tester writes and runs tests, then Objector reviews for security and quality before you commit.
// scenario 02
Configure
when: change .github/ settings
Any request touching instructions, skills, agents, or prompts is routed to the specialised agent-customization skill — never mixed with app code changes.
// scenario 03
Discuss
when: explore / understand
Boss switches to Teacher mode: Feynman-style explanations, concept breakdowns, and architecture discussions before a single line of code is written.
// agent.team
The Agent Team
Five specialised agents, each with a distinct skill set and scope. You only ever talk to Boss — the rest are activated automatically.
Boss
Routing & orchestration
Your single point of contact. Reads your intent, selects the right scenario, and delegates to Worker, Tester, Objector, or Teacher accordingly.
Worker
Full-stack implementation
Builds the feature end-to-end: types → data layer → API → hooks → UI components → page. Follows all coding instructions and reports back on every decision.
Tester
Unit tests & E2E coverage
Writes Jest/Vitest unit tests for new logic and generates Playwright E2E scripts. Runs tests and reports failures before the implementation is considered done.
Objector
Critical review
Reads the implementation report and raises objections on security gaps, performance anti-patterns, SEO issues, and accessibility failures — before code ships.
Teacher
Feynman-style explanations
Breaks down any concept, architecture, or codebase decision into clear, layered explanations. Ideal before starting a new feature or after a confusing Objector report.
// git.strategy
Branch Strategy
main
The promotional website you're reading right now. Built with Next.js + Tailwind and deployed as the public face of the project. Clone this branch if you want to run or fork the site.
copilot-settings
Contains only the .github/ directory — the instructions, skills, agents, and prompts. Check out this branch and copy .github/ into your own project to activate the full agent system.