Kun
GitHub
Switch language to العربية

PRD

PreviousNext

Configuration requirements by phase for the Kun engine

Product Requirements

Requirements for Kun — the configuration engine running Databayt's operations across a 4-person team, 14 repositories, and 5 products.

Constraints

ConstraintValue
Team size4 (tech, business, R&D, 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 100+ keywordsP0Done
Configuration hierarchy respectedP0Done

Agent Fleet

RequirementPriorityStatus
Stack chain (7): nextjs, react, typescript, tailwind, prisma, shadcn, authjsP0Done
Design chain (4): orchestration, architecture, pattern, structureP0Done
UI chain (4): shadcn, atom, template, blockP0Done
DevOps chain (3): build, deploy, testP0Done
VCS chain (2): git, githubP0Done
Specialized (8): middleware, i18n, semantic, sse, optimize, performance, comment, iconP1Done
Reference chain (4): hogwarts, souq, mkan, shifa product agentsP1Done
Handoff protocol between agentsP0Done

Skills, MCP, Hooks, Rules, Memory

RequirementPriorityStatus
17 skills with keyword triggersP0Done
18 MCP servers connectedP0Done
5 hooks (format, port, session)P0Done
8 path-scoped rulesP0Done
6 memory files persisting cross-sessionP1Done
38 allow + 4 deny permission rulesP0Done

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