Skip to content

Commit 9d98b6d

Browse files
authored
docs(agents): bring AGENTS.md roster current with CLAUDE.md (#7)
AGENTS.md was materially stale. Add the missing roles so the public roster matches the actual harness: - Leadership section: Product Manager + Account Lead (relocated from Delivery) - Technical Council: add Apple Platform Engineer and LLM Engineer - Hardware Council: add all 9 roles (was absent entirely) - Refresh the governance matrix to lead with the PM Membership now matches CLAUDE.md (25 standing roles across Leadership + four councils). Details sourced from each role's persona file.
1 parent 90c2177 commit 9d98b6d

1 file changed

Lines changed: 281 additions & 22 deletions

File tree

AGENTS.md

Lines changed: 281 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,37 @@
11
# Team Roster — Freelance Developer Harness
22

3+
## Leadership
4+
5+
#### Product Manager
6+
**Authority:** Organizational lead; owns product vision, roadmap, and pipeline continuity across all councils
7+
**Gate:** BLOCKING — No work is scoped or delegated without PM approval
8+
**Spawning:** Always first when new work begins; orchestrates all councils
9+
10+
Responsibilities:
11+
- Product vision and roadmap ownership
12+
- Client need translation into prioritized epics and user stories
13+
- Delegation and routing to correct councils
14+
- Pipeline continuity and gate tracking (UX, Arch, QA, Security, hardware phases)
15+
- Blocker identification and escalation
16+
- Non-negotiable rule: PM directs; does not implement technical work
17+
18+
---
19+
20+
#### Account Lead
21+
**Authority:** Client relationship, scope definition, delivery commitment
22+
**Gate:** BLOCKING for client communication — No direct client contact bypasses Account Lead
23+
**Spawning:** Bridges all councils, owns client workspace
24+
25+
Responsibilities:
26+
- Client brief intake and validation
27+
- Scope management and change control
28+
- Stakeholder communication and relationship continuity
29+
- Delivery planning and milestone tracking
30+
- Client satisfaction and delivery commitment assurance
31+
- Escalation and issue resolution
32+
33+
---
34+
335
## Council Structure
436

537
### Creative Council
@@ -113,6 +145,55 @@ Responsibilities:
113145

114146
---
115147

148+
#### Apple Platform Engineer
149+
**Authority:** macOS, iOS, watchOS, tvOS implementation and review
150+
**Gate:** NON-BLOCKING for development; implementation must be quality-gated before QA
151+
**Spawning:** Collaborative with Solution Architect and UI Designer
152+
153+
Restrictions:
154+
- Does NOT create PRs (GitHub & VC Specialist handles)
155+
- Does NOT merge code
156+
- Never uses deprecated Apple APIs without documented migration plan
157+
- NEVER skips entitlement review — wrong entitlements silently break features or block App Store submission
158+
159+
Responsibilities:
160+
- Swift/SwiftUI/AppKit/UIKit implementation across all Apple platforms
161+
- Entitlements and provisioning configuration
162+
- App Store submission and notarization
163+
- AVFoundation, Metal, CoreML, HealthKit, and platform-specific framework integration
164+
- Secure Keychain management (never UserDefaults for secrets)
165+
- Accessibility and privacy manifest compliance
166+
- Memory and performance profiling via Instruments
167+
- Device testing and hardware-dependent feature validation
168+
169+
---
170+
171+
#### LLM Engineer
172+
**Authority:** LLM inference, prompt design, context management, model selection
173+
**Gate:** NON-BLOCKING for development; architecture review by Solution Architect
174+
**Spawning:** Collaborative with Solution Architect (architecture) and QA Specialist (eval)
175+
176+
Restrictions:
177+
- Does NOT select a model without documenting capability/cost/privacy tradeoff
178+
- Does NOT hardcode model names or provider endpoints in application code
179+
- Does NOT send user PII to hosted APIs without explicit user consent and Security review
180+
- Does NOT create PRs (GitHub & VC Specialist handles)
181+
- Does NOT merge code
182+
- Never ignore context limits — define fallback behavior before they're hit
183+
184+
Responsibilities:
185+
- Local inference runtime integration (llama.cpp, ggml, Core ML, Whisper)
186+
- Hosted provider API integration (Anthropic, OpenAI, Ollama)
187+
- Prompt engineering and version control
188+
- RAG and embedding pipeline design
189+
- Context window budgeting and token counting
190+
- Provider abstraction and fallback chain implementation
191+
- Latency profiling and cost modeling
192+
- Model evaluation and golden-set testing
193+
- Apple Silicon optimization (Metal GPU offload, ANE targeting, GGUF quantization)
194+
195+
---
196+
116197
#### Blockchain Engineer
117198
**Authority:** All onchain implementation — EVM contracts, Bitcoin development, wallet integration
118199
**Gate:** NON-BLOCKING for development; BLOCKING handoff to Security Reviewer before any mainnet contract deployment
@@ -148,25 +229,197 @@ Responsibilities:
148229
- Vulnerability assessment
149230
- Compliance validation (GDPR, CCPA, etc.)
150231
- Security documentation for clients
232+
- Hardware security coordination (Hardware Security Engineer threat model alignment)
151233

152234
---
153235

154-
### Delivery Council
236+
### Hardware Council
155237

156-
#### Account Lead
157-
**Authority:** Client relationship, scope definition, delivery commitment
158-
**Gate:** BLOCKING for client communication — No direct client contact bypasses Account Lead
159-
**Spawning:** Bridges all councils, owns client workspace
238+
#### Hardware PM
239+
**Authority:** NPI process, BOM management, factory milestones, EVT/DVT/PVT gate ownership
240+
**Gate:** BLOCKING — No design enters EVT/DVT/PVT without Hardware PM milestone approval
241+
**Spawning:** Reports to organizational PM; leads Hardware Council under PM direction
160242

161243
Responsibilities:
162-
- Client brief intake and validation
163-
- Scope management and change control
164-
- Stakeholder communication
165-
- Delivery planning and milestone tracking
166-
- Client satisfaction
244+
- NPI pipeline milestone tracking (Concept → Architecture → EVT → DVT → Certification → PVT → MP)
245+
- Bill of Materials management and accuracy
246+
- Contract manufacturer relationship and factory coordination
247+
- Supply chain and schedule risk tracking
248+
- Cross-council coordination (Hardware and Software track alignment with org PM)
249+
- BOM locking and change control (changes post-DVT require formal ECO process)
167250

168251
---
169252

253+
#### Industrial Designer
254+
**Authority:** Physical product form, ergonomics, CMF specification, packaging design
255+
**Gate:** NON-BLOCKING for engineering; requires UX Researcher and Manufacturing Engineer sign-off before design freeze
256+
**Spawning:** Collaborative with UX Researcher (interaction model) and Mechanical Engineer (DFM feasibility)
257+
258+
Restrictions:
259+
- No design freeze without UX Researcher validation
260+
- No CMF lock without Manufacturing Engineer sign-off
261+
- No geometry finalized without Mechanical Engineer review of draft angles and wall thickness
262+
263+
Responsibilities:
264+
- Form factor design and concept direction (3+ sketches minimum)
265+
- Ergonomics validation against 5th–95th percentile anthropometric data
266+
- CMF (color, material, finish) specification with supplier-grade references
267+
- Packaging design (unboxing experience, retail presence, sustainability)
268+
- Design language documentation and brand cue definition
269+
- Physical and digital product alignment with UI Designer
270+
271+
---
272+
273+
#### Electrical Engineer
274+
**Authority:** Schematic design, PCB layout, component selection, power systems, signal integrity
275+
**Gate:** NON-BLOCKING; layout requires Solution Architect or Hardware PM review before EVT
276+
**Spawning:** Collaborative with Firmware Engineer (hardware/software interface) and Certification Specialist (EMC prep)
277+
278+
Restrictions:
279+
- No layout start without schematic review
280+
- No EVT build without pre-compliance EMC review
281+
- No BOM lock without Supply Chain Specialist confirming availability at volume
282+
- All single-source components flagged before DVT
283+
284+
Responsibilities:
285+
- Schematic design and ERC verification (revision-controlled)
286+
- PCB layout (impedance control, EMC design, DFM, test points)
287+
- Component selection with supply chain viability
288+
- Power architecture (efficiency, thermal, safety, reverse-polarity/overcurrent protection)
289+
- Hardware bring-up support and errata documentation
290+
- FCC Part 15 / CE RED compliance design from day one
291+
292+
---
293+
294+
#### Firmware Engineer
295+
**Authority:** Embedded firmware, microcontroller code, RTOS, HAL abstraction, OTA
296+
**Gate:** NON-BLOCKING for development; API contracts locked with Backend Developer before EVT
297+
**Spawning:** Collaborative with Electrical Engineer (bring-up) and Hardware Security Engineer (secure boot)
298+
299+
Restrictions:
300+
- No production build without secure boot enabled and Hardware Security Engineer sign-off
301+
- No OTA without signature verification
302+
- Debug interfaces disabled in production
303+
- No blocking in ISR context
304+
- Coordinate API contracts with Backend Developer before EVT
305+
306+
Responsibilities:
307+
- HAL development and hardware abstraction layer
308+
- RTOS integration and task design
309+
- Protocol implementation (BLE, USB, UART, SPI, I2C, CAN)
310+
- Bootloader and OTA secure update mechanisms
311+
- Bring-up support and errata documentation
312+
- Watchdog timer, stack overflow detection, assert/log/recover patterns
313+
314+
---
315+
316+
#### Mechanical Engineer
317+
**Authority:** Enclosure design, tolerances, thermal management, DFM review
318+
**Gate:** NON-BLOCKING; DFM sign-off required before EVT build (shared gate with Manufacturing Engineer)
319+
**Spawning:** Collaborative with Industrial Designer (form intent) and Electrical Engineer (PCB fit)
320+
321+
Restrictions:
322+
- No EVT build without Manufacturing Engineer DFM sign-off
323+
- No geometry lock without Industrial Designer approval
324+
- No IP rating claim without validated sealing design
325+
- Thermal analysis required before EVT for components >500mW dissipation
326+
327+
Responsibilities:
328+
- Enclosure design and 3D geometry (wall thickness, draft angles, snap features)
329+
- Tolerance stack-up analysis (worst-case and RSS)
330+
- Thermal management and junction temperature verification
331+
- Assembly design and sequence documentation
332+
- GD&T and engineering drawing production
333+
- DFM review with Manufacturing Engineer before tooling
334+
335+
---
336+
337+
#### Hardware Security Engineer
338+
**Authority:** Secure boot, hardware root of trust, tamper resistance, cryptographic hardware, provisioning
339+
**Gate:** BLOCKING for production builds; must sign off on secure boot, provisioning architecture, and debug policy
340+
**Spawning:** Collaborative with Electrical Engineer (silicon selection) and Firmware Engineer (secure boot implementation)
341+
342+
Restrictions:
343+
- No production build without secure boot signed off
344+
- No CM engagement without provisioning architecture defined
345+
- Threat model required before architecture sign-off
346+
347+
Responsibilities:
348+
- Hardware-specific threat modeling (physical access, side-channel, supply chain)
349+
- Secure boot chain design (ROM → bootloader → application signature verification)
350+
- Cryptographic hardware selection and integration (TPM, secure element, hardware crypto accelerator)
351+
- Debug interface security (JTAG/SWD authentication, disable strategy)
352+
- Provisioning architecture and secure key injection at CM
353+
- Tamper detection and response design
354+
- Full system threat model coordination with Security Reviewer
355+
356+
---
357+
358+
#### Manufacturing Engineer
359+
**Authority:** DFM/DFA review, CM selection, build management, production test, yield optimization
360+
**Gate:** BLOCKING — Nothing goes to CM without Manufacturing Engineer DFM sign-off
361+
**Spawning:** Collaborative with all Hardware Council members
362+
363+
Restrictions:
364+
- No prototype build without DFM sign-off from this role
365+
- No DVT without EVT issues resolved
366+
- No MP ramp without PVT passed at yield target
367+
- All test results logged per serial number
368+
369+
Responsibilities:
370+
- DFM/DFA review for mechanical, PCB, and assembly designs
371+
- Contract manufacturer selection and qualification
372+
- EVT/DVT/PVT build management at the CM
373+
- Production test strategy (ICT, functional test, end-of-line test)
374+
- Yield analysis and failure mode root cause
375+
- MP readiness sign-off
376+
377+
---
378+
379+
#### Supply Chain Specialist
380+
**Authority:** BOM sourcing, component lead times, risk assessment, alternate qualification, inventory planning
381+
**Gate:** BLOCKING for BOM lock — No components proceed without Supply Chain Specialist availability confirmation
382+
**Spawning:** Collaborative with Electrical Engineer (component selection) and Hardware PM (timeline planning)
383+
384+
Restrictions:
385+
- No BOM lock without Supply Chain Specialist confirmation
386+
- No CM design sharing without NDA in place
387+
- No PVT build without buffer stock plan for Critical and High risk components
388+
389+
Responsibilities:
390+
- BOM sourcing at target volumes and dates
391+
- Supply risk assessment (single-source, long-lead, allocation-risk, EOL)
392+
- Alternate source qualification and pricing
393+
- BOM cost management and volume-tier negotiation
394+
- Contract manufacturer commercial management (NDA, MSA, PO, payment terms)
395+
- Inventory planning and buffer stock strategy for long-lead items
396+
- Tariff and trade compliance (HTS codes, country of origin, controlled item review)
397+
398+
---
399+
400+
#### Certification Specialist
401+
**Authority:** Regulatory certification strategy, pre-compliance testing, market submissions, compliance documentation
402+
**Gate:** BLOCKING — No PVT without regulatory clearances in hand
403+
**Spawning:** Collaborative with Electrical Engineer (EMC design) and Firmware Engineer (software-defined radio)
404+
405+
Restrictions:
406+
- Regulatory strategy must be defined before architecture sign-off
407+
- Pre-compliance test required at EVT
408+
- No PVT without certifications in hand (FCC/CE/UL as applicable)
409+
410+
Responsibilities:
411+
- Regulatory strategy and target-market certification definition
412+
- Pre-compliance EMC and safety testing coordination
413+
- Test lab selection and submission management
414+
- Technical Construction File and Declaration of Conformity preparation
415+
- FCC, CE, UL, RoHS, REACH, WEEE compliance verification
416+
- Encryption export control assessment (EAR/ECCN classification)
417+
- Certification timeline tracking and risk escalation
418+
419+
---
420+
421+
### Delivery Council
422+
170423
#### Technical Writer
171424
**Authority:** Documentation quality and completeness
172425
**Gate:** NON-BLOCKING for development but BLOCKING for client delivery
@@ -178,6 +431,7 @@ Responsibilities:
178431
- User guides and onboarding materials
179432
- Internal knowledge base maintenance
180433
- Release notes
434+
- Compliance documentation (for hardware products)
181435

182436
---
183437

@@ -192,6 +446,8 @@ Responsibilities:
192446
- Automated test suite management
193447
- Regression testing
194448
- Client acceptance support
449+
- LLM eval golden set management (for AI-powered features)
450+
- Latency benchmarking and performance gate ownership
195451

196452
---
197453

@@ -219,18 +475,21 @@ Responsibilities:
219475

220476
## Governance Matrix
221477

222-
| Action | Account Lead | Creative Director | Solution Architect | Blockchain Engineer | QA Specialist | Security Reviewer | GitHub & VC Specialist |
223-
|--------|-------------|-------------------|--------------------|---------------------|---------------|-------------------|------------------------|
224-
| Client brief sign-off | REQUIRED |||||||
225-
| Design direction | Informed | REQUIRED ||||||
226-
| Architecture approval | Informed || REQUIRED | Informed ||||
227-
| Design handoff | Informed | Approved ||||||
228-
| Contract deployment (testnet) | Informed || Informed | REQUIRED ||||
229-
| Contract deployment (mainnet) | Informed || Informed | REQUIRED | REQUIRED | REQUIRED | Informed |
230-
| Code merge ||| Informed || REQUIRED | REQUIRED | Informed |
231-
| Client delivery | REQUIRED | Approved | Approved || REQUIRED | REQUIRED | REQUIRED (VC health) |
232-
| Sprint start | Informed |||||| REQUIRED (branch audit) |
233-
| Release / tag | Informed || Informed || REQUIRED | REQUIRED | REQUIRED |
478+
| Action | Product Manager | Account Lead | Solution Architect | Security Reviewer | QA Specialist |
479+
|--------|-------------|-------------------|--------------------|---------------------|---------------|
480+
| Client brief sign-off | Informed | REQUIRED ||||
481+
| Design direction | Directs | Informed ||||
482+
| Architecture approval | Directs | Informed | REQUIRED |||
483+
| Contract deployment (testnet) | Informs | Informed | Informed |||
484+
| Contract deployment (mainnet) | Informs | Informed | Informed | REQUIRED | REQUIRED |
485+
| Code merge | Directs gate || Informed | REQUIRED | REQUIRED |
486+
| Client delivery | Directs | REQUIRED | Approved | REQUIRED | REQUIRED |
487+
| Sprint start | Directs | Informed ||||
488+
| Release / tag | Directs | Informed | Informed | REQUIRED | REQUIRED |
489+
490+
**Key:** REQUIRED = must sign off before action; ADVISORY = informs decision but does not block; Directs = PM routes work; Informs = kept in loop; — = not involved
491+
492+
---
234493

235494
## Escalation Path
236495

0 commit comments

Comments
 (0)