Configuration requirements by phase for the Kun engine

Product Requirements

Requirements for Kun — the configuration engine running Databayt's operations across a 7-person team, the databayt org repositories, and the product line.

Constraints

ConstraintValue
Team size7 (3 tech, 2 business, 1 R&D, 1 facilitator)
Revenue pipelineHogwarts pilot
LicenseSSPL (open source, commercial use requires license)

Phase 1: Developer Engine (Done)

CLAUDE.md Configuration

RequirementPriorityStatus
User-level CLAUDE.md with stack preferencesP0Done
Project-level CLAUDE.md with contextP0Done
Repo-level CLAUDE.md with the keyword vocabulary (160 spells)P0Done
Configuration hierarchy respectedP0Done

Agent Fleet

RequirementPriorityStatus
Company fleet (19): captain, business, delivery, engine, product referencesP0Done
Stack fleet (27): framework, design, UI, DevOps, platform specialistsP0Done
Both fleets distributable as plugins (kun-company, kun-stack)P1Done
Tier aliases instead of pinned model versionsP0Done
Handoff protocol between agentsP0Done

Skills, MCP, Hooks, Rules, Memory

RequirementPriorityStatus
Skills with keyword triggers (55 shipped)P0Done
MCP servers connected (20 live)P0Done
Hooks for format, port, session, guards (9)P0Done
Path-scoped rules (37 domain + 5 cross-cutting)P0Done
Memory files persisting cross-sessionP1Done
Destructive-command guard on PreToolUseP0Done

Phase 2: Team Engine (Current)

Team Configuration

RequirementPriority
Shared settings.json via gitP0
Local override support (.local.json)P0
One-command installer (< 30 min setup)P0
Role-based configs (engineer, business, content)P0
Accessibility: screen reader compatible outputsP0

Hogwarts Pilot (King Fahad Schools)

RequirementPriority
Admission block — 5-pass QA cleanP0
Notification system — SMS + in-appP0
Messaging — school-parent communicationP1
Arabic RTL — complete, no LTR remnantsP0
Demo environment — demo.databayt.org stableP0

Agent Teams (Experimental)

RequirementPriority
Lead agent coordinationP0
Parallel agent execution (3+)P0
Git worktree isolationP0
Consolidated PR outputP0

CI/CD & Automation

RequirementPriority
GitHub Actions code review via Agent SDKP0
Pattern compliance check in CIP0
Scheduled cloud tasks (health, deps, sync)P1
Auto-fix pipeline for trivial issuesP1

Business Operations

RequirementPriority
Cowork for Ali (client outreach, proposals)P1
Cowork for Samia (Arabic content, docs, research)P1
Stripe MCP for financial trackingP1
Claude Apps (Slack, Figma)P2

Phase 3: Company Engine (Future)

Agent SDK Platform

RequirementPriority
CI/CD review agent in GitHub ActionsP0
Deploy verification agentP0
School onboarding automation agentP1
Client report generation agentP1

Enterprise & Optimization

RequirementPriority
SSO (SAML/OIDC) + SCIMP0
Audit loggingP0
Prompt caching (90% savings)P0
Batch API for CI/CD (50% savings)P0
Pattern distribution packagingP1

Non-Functional Requirements

CategoryRequirementTarget
PerformanceClaude Code startup< 5 seconds
PerformanceKeyword → workflow start< 3 seconds
PerformanceAutopilot cycle100 turns
ReliabilityConfiguration load100% success
ReliabilityHook executionGuaranteed
UsabilityEngineer onboarding< 30 minutes
UsabilityNon-dev onboarding< 1 hour
AccessibilityScreen reader navigationFull support
AccessibilityVoiceOver mobile testingR&D workflow
QualityPattern compliance90%+
SecurityDestructive commandsAlways blocked
SecuritySecretsNever in git
CostTotal monthly< $1,000
CostAPI reduction (Phase 3)95% via caching + batch

Acceptance Criteria

Phase 2 Complete When:

  1. Any team member can set up Kun in < 30 minutes
  2. Hogwarts admission block passes 5-pass QA on both environments
  3. Business role can use Cowork for client communication independently
  4. R&D role can use Cowork with screen reader for content creation
  5. Agent Teams can parallelize a 3-tab feature build
  6. Scheduled tasks run daily health checks on ed.databayt.org