Files
AgentCompany/built-in skills/strategy/runbooks/scenario-enterprise-feature.md
T
ZacharyZhang-NY 86aa6fdb29 Ship skills built-in: bundle the catalogue, assign per hire, force humanizer
Skills no longer come from the user's ~/.agents library - most users have
none, and the CEO branch that compiled the entire catalogue into its
prompt overflowed the model context (1.1MB) and failed every CEO run.

- Bundle "built-in skills/" with the app (extraResources) and stage it
  at startup into <profile>/builtin-skills as one dir-per-skill copy -
  both bundle shapes (SKILL.md dirs and flat category .md files)
  normalize into the same importable layout
- Import the staged catalogue per org at startup and inside onboarding,
  so the CEO's first run already carries it
- Forced house style: resolveRuntimeSnapshot unions the humanizer skill
  into every agent's runtime (CEO included) as a resolution rule - no
  binding row to forget, delete, or bypass; revoke_skill refuses it
- CEO staffs hires with skills: hire_agent accepts a skills array,
  grant_skill/revoke_skill adjust later, list_skills now shows
  descriptions from skill frontmatter
- Kill the c_suite compile-all branch; everyone resolves bindings-only,
  capped at 200k chars with omissions named in the prompt
- Remove the Skills settings page and its import/sync/test IPC surface;
  drop ~/.agents discovery and the AGENTCOMPANY_NEW_SKILLS_ROOT seam in
  favor of AGENTCOMPANY_NEW_BUILTIN_SKILLS_DIR
- Tests: staging/import/forced-resolution/cap units, real-bundle CI
  check, e2e asserts the tab is gone and the catalogue self-imports
2026-07-08 21:18:50 -04:00

6.1 KiB

🏢 Runbook: Enterprise Feature Development

Mode: NEXUS-Sprint | Duration: 6-12 weeks | Agents: 20-30


Scenario

You're adding a major feature to an existing enterprise product. Compliance, security, and quality gates are non-negotiable. Multiple stakeholders need alignment. The feature must integrate seamlessly with existing systems.

Agent Roster

Core Team

Agent Role
Agents Orchestrator Pipeline controller
Project Shepherd Cross-functional coordination
Senior Project Manager Spec-to-task conversion
Sprint Prioritizer Backlog management
UX Architect Technical foundation
UX Researcher User validation
UI Designer Component design
Frontend Developer UI implementation
Backend Architect API and system integration
Senior Developer Complex implementation
DevOps Automator CI/CD and deployment
Evidence Collector Visual QA
API Tester Endpoint validation
Reality Checker Final quality gate
Performance Benchmarker Load testing

Compliance & Governance

Agent Role
Legal Compliance Checker Regulatory compliance
Brand Guardian Brand consistency
Finance Tracker Budget tracking
Executive Summary Generator Stakeholder reporting

Quality Assurance

Agent Role
Test Results Analyzer Quality metrics
Workflow Optimizer Process improvement
Experiment Tracker A/B testing

Execution Plan

Phase 1: Requirements & Architecture (Week 1-2)

Week 1: Stakeholder Alignment
├── Project Shepherd → Stakeholder analysis + communication plan
├── UX Researcher → User research on feature need
├── Legal Compliance Checker → Compliance requirements scan
├── Senior Project Manager → Spec-to-task conversion
└── Finance Tracker → Budget framework

Week 2: Technical Architecture
├── UX Architect → UX foundation + component architecture
├── Backend Architect → System architecture + integration plan
├── UI Designer → Component design + design system updates
├── Sprint Prioritizer → RICE-scored backlog
├── Brand Guardian → Brand impact assessment
└── Quality Gate: Architecture Review (Project Shepherd + Reality Checker)

Phase 2: Foundation (Week 3)

├── DevOps Automator → Feature branch pipeline + feature flags
├── Frontend Developer → Component scaffolding
├── Backend Architect → API scaffold + database migrations
├── Infrastructure Maintainer → Staging environment setup
└── Quality Gate: Foundation verified (Evidence Collector)

Phase 3: Build (Week 4-9)

Sprint 1-3 (Week 4-9):
├── Agents Orchestrator → Dev↔QA loop management
├── Frontend Developer → UI implementation (task by task)
├── Backend Architect → API implementation (task by task)
├── Senior Developer → Complex/premium features
├── Evidence Collector → QA every task (screenshots)
├── API Tester → Endpoint validation every API task
├── Experiment Tracker → A/B test setup for key features
│
├── Bi-weekly:
│   ├── Project Shepherd → Stakeholder status update
│   ├── Executive Summary Generator → Executive briefing
│   └── Finance Tracker → Budget tracking
│
└── Sprint Reviews with stakeholder demos

Phase 4: Hardening (Week 10-11)

Week 10: Evidence Collection
├── Evidence Collector → Full screenshot suite
├── API Tester → Complete regression suite
├── Performance Benchmarker → Load test at 10x traffic
├── Legal Compliance Checker → Final compliance audit
├── Test Results Analyzer → Quality metrics dashboard
└── Infrastructure Maintainer → Production readiness

Week 11: Final Judgment
├── Reality Checker → Integration testing (default: NEEDS WORK)
├── Fix cycle if needed (2-3 days)
├── Re-verification
└── Executive Summary Generator → Go/No-Go recommendation

Phase 5: Rollout (Week 12)

├── DevOps Automator → Canary deployment (5% → 25% → 100%)
├── Infrastructure Maintainer → Real-time monitoring
├── Analytics Reporter → Feature adoption tracking
├── Support Responder → User support for new feature
├── Feedback Synthesizer → Early feedback collection
└── Executive Summary Generator → Launch report

Stakeholder Communication Cadence

Audience Frequency Agent Format
Executive sponsors Bi-weekly Executive Summary Generator SCQA summary (≤500 words)
Product team Weekly Project Shepherd Status report
Engineering team Daily Agents Orchestrator Pipeline status
Compliance team Monthly Legal Compliance Checker Compliance status
Finance Monthly Finance Tracker Budget report

Quality Requirements

Requirement Threshold Verification
Code coverage > 80% Test Results Analyzer
API response time P95 < 200ms Performance Benchmarker
Accessibility WCAG 2.1 AA Evidence Collector
Security Zero critical vulnerabilities Legal Compliance Checker
Brand consistency 95%+ adherence Brand Guardian
Spec compliance 100% Reality Checker
Load handling 10x current traffic Performance Benchmarker

Risk Management

Risk Probability Impact Mitigation Owner
Integration complexity High High Early integration testing, API Tester in every sprint Backend Architect
Scope creep Medium High Sprint Prioritizer enforces MoSCoW, Project Shepherd manages changes Sprint Prioritizer
Compliance issues Medium Critical Legal Compliance Checker involved from Day 1 Legal Compliance Checker
Performance regression Medium High Performance Benchmarker tests every sprint Performance Benchmarker
Stakeholder misalignment Low High Bi-weekly executive briefings, Project Shepherd coordination Project Shepherd