devloom 1.0.0 → 1.2.0

package/.ai/core.dsl

@@ -0,0 +1,44 @@
+VER:1
+LANG:EN
+STYLE: Deterministic|LowToken|GitDiffable|HumanMaintainable
+FMT:
+- MD=human or mixed docs
+- JSONM=minified JSON for AI-only state
+TERMS: AC|ADR|A11y|API|Arch|BE|CleanArch|Ctx|Docs|E2E|FE|NFR|QA|RCA|Regr|ResponsiveUI|TDD|US
+STATE:
+- CFG=.opencode/devloom/project/config.json
+- BOARD=.opencode/devloom/project/board.json
+- PSTATE=.opencode/devloom/project/state.json
+- REQ=.opencode/devloom/requirements.md
+- PLAN=.opencode/devloom/plan.md
+- DEF=.opencode/devloom/defects.json
+PRINCIPLES:
+- SOLID|CleanCode|CleanArch|DRY|KISS|YAGNI
+- TDD: test-first for logic, failing-repro-first for bugs
+- LayeredArch: domain<-app<-infra<-ui|DependencyInversion|no domain->framework coupling
+- SmallFns|IntentionRevealingNames|NoDeadCode|HandleErrors|GuardEdges
+- UX: Accessible(WCAG-AA)|Consistent|Responsive|ClearFeedback|ErrorRecovery
+- Surgical: change only what the task requires, smallest correct diff
+- Forensic: evidence-based, trace before acting, prove cause, verify after
+- CorrectSolution: root-cause fix using the right/idiomatic approach; NO workarounds/hacks/suppression
+- Precise: confirm assumptions against code/docs, never guess
+RULES:
+- EnglishOnly
+- ApplyPrinciples
+- SingleActive
+- PersistAll
+- NoDropPending
+- LoadMemoryEveryPrompt
+- UseRelevantSkillsEveryPrompt
+- OfficialDocsFirst
+- LatestStableCheck for stack-specific work
+- TDDReq for code change
+- RegrReq for code change
+- NoScopeCreep
+- SecureByDefault
+- DeltaCommOnly
+- AppendPromptAsLastTask
+- AutoMaintainTicketsTodosPlan
+- DelegateByDefault
+- ShortStableKeys in JSONM
+JSON_KEYS: v|id|type|title|status|ac|deps|files|tests|cols|ts|ctx|next

package/.ai/skills.dsl

@@ -0,0 +1,39 @@
+LOAD_ORDER:
+- detect domain
+- load matching skills
+- always apply core flow
+MAP:
+- REQ|PLAN|FE|BE|API arch=planning
+- FE|BE|API impl|BUG|FIX|RCA=development
+- TEST|PERF|REVIEW|REGR=quality-assurance
+- EXP|ROUTE|FORM|DOM|A11Y|APIV|CONTRACT|JOURNEY|STATE|VISUAL|RESPONSIVE|MOTION=app-verification
+- SEC=security-review
+- DOC=documentation
+- DESIGN|VISUALDIR|DESIGNFILE=visual-direction
+- DESIGNGROUND|TOKENS|STYLEGUIDE=design-grounding
+- WEBUI|LANDING|WEBSITE=web-design
+- APPUI|MOBILEUI=app-design
+- GAMEUI|HUD|GAMESCREEN=game-design
+- ANIMATION|TRANSITION|MICROINTERACTION=motion-design
+- DESIGNSYSTEM|COMPONENTLIBRARY=design-system
+- VISUALCRITIQUE|VISUALSCORE|VISUALGATE=visual-critique
+- VISUALQUALITY|UIQUALITYBAR=visual-quality-gate
+- VISUALREGRESSION|SHOTDIFF=visual-regression
+MATCH:
+- ui|react|vue|angular|css|html|component|layout=>FE
+- design|design brief|design file|visual direction|redesign|mockup fidelity|design contract=>DESIGN
+- web page|landing|website|responsive layout=>WEBUI|DESIGN
+- app screen|mobile ui|dashboard ui=>APPUI|DESIGN
+- game hud|game ui|game screen=>GAMEUI|DESIGN
+- animation|transition|micro-interaction|motion|hover effect=>MOTION|DESIGN
+- design system|tokens|style guide|component library|spacing scale=>DESIGNSYSTEM
+- visual critique|visual score|visual pass|visual fail|screenshot review|looks off|ugly=>VISUALCRITIQUE
+- visual quality|quality bar|polish|visual regression|shot diff=>VISUALQUALITY|VISUALREGRESSION
+- api|endpoint|service|route|graphql|rest=>BE|API
+- crud|dto|schema|serializer|mapper|expose|exposure|payload|input|output|internal component|internal module=>SEC
+- test|spec|jest|vitest|pytest|e2e=>TEST
+- auth|secret|cors|xss|csrf|owasp=>SEC
+- perf|slow|cache|bundle|lcp=>PERF
+- bug|error|fail|crash|broken=>BUG
+- readme|docs|adr|comment=>DOC
+REPORT: ActivatedSkills=<list>

package/.ai/verify.dsl

@@ -0,0 +1,97 @@
+UX_BAR: Accessible(WCAG-AA)|Consistent|Responsive|ClearFeedback|ErrorRecovery|NoLayoutShift
+EXPLORE:
+- visit all reachable routes
+- enumerate buttons|links|forms|modals|tables|tabs
+- continue until no new surface
+- OUT: exploration-report.json
+DOM:
+- size>0
+- visible
+- inViewport
+- notBlocked
+- computedStyleSane
+ROUTE:
+- render
+- noBlank
+- noCrash
+- noConsoleErr
+- noNavFail
+- noHydrationErr
+- domVisible
+- noBlockedClick
+FORM:
+- valid
+- invalid
+- required
+- boundary
+- loading
+- successMsg
+- errorMsg
+A11Y:
+- role
+- label
+- focus
+- kbNav
+- escClose
+- contrast
+- semanticHtml
+API:
+- auth
+- authz
+- inputVal
+- outputSchema
+- statusCodes
+- errorShape
+- paging/filter/sort if applicable
+CONTRACT:
+- generate/open OpenAPI when needed
+- compare runtime fields/types/status to contract
+STATE:
+- enumerate valid states
+- verify transitions + recovery paths
+JOURNEY:
+- derive from REQ+routes+ui
+- CRUD
+- LoginFlow
+- SearchFilterSort
+- ErrorRecovery
+SEC:
+- depAudit
+- noSecrets
+- cors
+- sanitize
+- auth
+- authz
+- inputVal
+- outputSchema
+- leastPrivilege
+- noInternalFieldLeak
+- massAssignment
+- overposting
+- xss
+- csrf
+- idor
+PERF:
+- loadTime
+- noLeak
+- noExcessRender
+- bundleOk
+VISUAL:
+- screenshots available? if no: VISUAL_CRITIQUE_LIMITED (never fake VISUAL_PASS)
+- score vs design.md contract (10 dims: hierarchy, spacing, typography, color, alignment, consistency, affordance, density, polish, fidelity)
+- no layout overflow|no clipped text|no overlapping elements
+- component states match design tokens
+- accept critic verdict passed by orchestrator (CRITIC_VERDICT)
+- OUT: VISUAL_PASS|VISUAL_FAIL with scores
+RESPONSIVE:
+- 360|768|1280 viewports
+- no horizontal scroll
+- no overlap|no truncation of critical content
+- touch targets >=44px on small viewport
+- images/svg scale correctly
+MOTION:
+- respects prefers-reduced-motion
+- durations within budget (<=300ms standard|<=500ms complex)
+- no layout shift during animation
+- entrance/exit states complete (no stuck opacity/transform)
+- easing consistent with design.md

package/.ai/workflow.dsl

@@ -0,0 +1,81 @@
+FLOW: Triage>MinimalChain>Verify>Regr>Done
+TRIAGE: classify intent first|run only matching chain+conditions|never full pipeline by default
+CHAINS:
+- feature=planner>developer>qa>documenter
+- bug=developer(rootCause+fix)>qa(regr)
+- refactor=planner(plan)>developer>qa
+- small(<=2files,noNewBehavior)=developer>qa
+- docsOnly=planner(validate)>documenter
+- specOnly=planner(REQ)
+- planOnly=planner(PLAN)
+- explore=verifier(scope=explore)
+- verifyOnly=qa+verifier(applicableScopes)
+COND_ADDONS:
+- UI=>verifier(scope=route,form,a11y)
+- UI=>visual-director(DESIGN_FILE)>persist .opencode/devloom/context/design.md>developer>visual-critic(loop<=3)
+- visualRequired=>criticVerdict recorded before DONE|VISUAL_CRITIQUE_LIMITED only if no screenshots available
+- backendOnly(API|infra|docs)=>never route visual agents|never set VISUAL_REQUIRED
+- API=>verifier(scope=api,contract)
+- CRUD|exposure=>security(mandatory)
+- userFlow=>verifier(scope=journey,state)
+DEPS:
+- developer requires plan for non-trivial work
+- documenter only after verified impl
+- qa regression always after a defect fix
+ANTILOOP:
+- no orchestrator self-delegation
+- no subagent calls orchestrator
+- every orchestrator turn: task()|DEVLOOM_DONE|BLOCKED+reason
+- same agent+same input max2 then mark blocked + BLOCKED report (orchestrator handles recovery inline)
+SUBAGENTS:
+- Plan=devloom-planner
+- Impl/Fix=devloom-developer
+- Verify/Review/Regr=devloom-qa
+- AppVerify=devloom-verifier(scope=explore|route|dom|form|a11y|api|contract|journey|state|visual|responsive|motion)
+- Security=devloom-security
+- Docs=devloom-documenter
+- ImageAnalysis=devloom-vision
+- DesignBrief=devloom-visual-director(emits DESIGN_FILE|read-only)
+- VisualCritique=devloom-visual-critic(VISUAL_SCORE+TOP_3_PROBLEMS+DO_NOT_CHANGE+VISUAL_DELTA|read-only|max 3 cycles)
+QUEUE:
+- load CFG|BOARD|PSTATE on every prompt
+- load memory and relevant skills on every prompt before planning new work
+- append the current user prompt as the last task/todo before routing execution
+- create or update tickets, todos, and plan entries automatically for every prompt
+- if pending work exists: continue it first
+- if user reprioritizes: persist old active, then switch
+- doing<=1 unless explicit override
+PHASES:
+- Analysis=req+constraints+openqs
+- Docs=source check+plan+ticket map+ADR/doc deltas
+- Impl=one ticket only|min change|tests
+- Verify=lint+unit+integration+e2e as applicable
+- Regr=targeted impacted checks + full gate before done
+- Done=all AC pass|gates pass|no open high defect
+GATES:
+- build
+- lint
+- unit
+- integration
+- e2e
+- routes
+- buttons
+- forms
+- links
+- journeys
+- api
+- a11y
+- responsive
+- visual
+- perf
+- security
+- noOpenDefects
+FAIL_PATH: defect>developer(rootCauseFix)>qa(regr)|max3cycles>mark blocked+escalate
+DELEGATION:
+- use the mapped DevLoom subagent for each phase whenever one exists
+- do not perform specialist phase work directly in the orchestrator when a mapped subagent is available
+- run devloom-security whenever work adds/changes CRUD endpoints or exposes internal component/module data through inputs or outputs
+- orchestrator may summarize, route, persist state, and decide next action, but implementation and verification work must be delegated
+- orchestrator must keep task/todo/plan state current before and after each delegated phase
+- orchestrator must save state at every phase boundary, before reprioritization, and before pause/finish
+- if delegation fails or a subagent is unavailable, log the failure, retry once with a corrected prompt, then mark blocked and report BLOCKED

package/.opencode/themes/devloom-night-owl.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://opencode.ai/theme.json",
+  "name": "DevLoom Night Owl",
+  "author": "DevLoom",
+  "defs": {
+    "owlBg": "#011627",
+    "owlBgPanel": "#0a1f2e",
+    "owlBgElement": "#0f2a3d",
+    "owlBgHover": "#15344a",
+    "owlBgSelection": "#1d3b52",
+    "owlFg": "#d6deeb",
+    "owlFgMuted": "#607e99",
+    "owlFgDim": "#3a6075",
+    "owlBorder": "#1b3b4f",
+    "owlBorderActive": "#7fdbca",
+    "owlCyan": "#7fdbca",
+    "owlTeal": "#5f7e97",
+    "owlOrange": "#f78c6c",
+    "owlYellow": "#ecc48d",
+    "owlGreen": "#addb67",
+    "owlRed": "#ff5874",
+    "owlPurple": "#c792ea",
+    "owlBlue": "#82aaff",
+    "owlPink": "#f07178",
+    "owlDiffAdd": "#1a3a2a",
+    "owlDiffRemove": "#3a1520",
+    "owlHighlightAdd": "#2d5a3d",
+    "owlHighlightRemove": "#5a2030"
+  },
+  "theme": {
+    "primary": { "dark": "owlCyan", "light": "owlTeal" },
+    "secondary": { "dark": "owlTeal", "light": "owlBlue" },
+    "accent": { "dark": "owlPurple", "light": "owlPink" },
+    "error": { "dark": "owlRed", "light": "owlRed" },
+    "warning": { "dark": "owlOrange", "light": "owlOrange" },
+    "success": { "dark": "owlGreen", "light": "owlGreen" },
+    "info": { "dark": "owlBlue", "light": "owlBlue" },
+    "text": { "dark": "owlFg", "light": "owlBg" },
+    "textMuted": { "dark": "owlFgMuted", "light": "owlFgMuted" },
+    "background": { "dark": "owlBg", "light": "#f0f4f8" },
+    "backgroundPanel": { "dark": "owlBgPanel", "light": "#e2e8f0" },
+    "backgroundElement": { "dark": "owlBgElement", "light": "#cbd5e1" },
+    "backgroundHover": { "dark": "owlBgHover", "light": "#b0c4de" },
+    "backgroundSelection": { "dark": "owlBgSelection", "light": "#94a3b8" },
+    "border": { "dark": "owlBorder", "light": "#94a3b8" },
+    "borderActive": { "dark": "owlBorderActive", "light": "owlCyan" },
+    "borderSubtle": { "dark": "owlBgSelection", "light": "#cbd5e1" },
+    "diffAdded": { "dark": "owlGreen", "light": "owlGreen" },
+    "diffRemoved": { "dark": "owlRed", "light": "owlRed" },
+    "diffContext": { "dark": "owlFgMuted", "light": "owlFgMuted" },
+    "diffHunkHeader": { "dark": "owlTeal", "light": "owlTeal" },
+    "diffHighlightAdded": { "dark": "owlGreen", "light": "owlGreen" },
+    "diffHighlightRemoved": { "dark": "owlRed", "light": "owlRed" },
+    "diffAddedBg": { "dark": "owlDiffAdd", "light": "#dcfce7" },
+    "diffRemovedBg": { "dark": "owlDiffRemove", "light": "#fee2e2" },
+    "diffContextBg": { "dark": "owlBgPanel", "light": "#f1f5f9" },
+    "diffLineNumber": { "dark": "owlFgDim", "light": "#94a3b8" },
+    "diffAddedLineNumberBg": { "dark": "owlDiffAdd", "light": "#dcfce7" },
+    "diffRemovedLineNumberBg": { "dark": "owlDiffRemove", "light": "#fee2e2" },
+    "markdownText": { "dark": "owlFg", "light": "#1e293b" },
+    "markdownHeading": { "dark": "owlCyan", "light": "owlTeal" },
+    "markdownLink": { "dark": "owlBlue", "light": "owlBlue" },
+    "markdownLinkText": { "dark": "owlCyan", "light": "owlCyan" },
+    "markdownCode": { "dark": "owlGreen", "light": "owlGreen" },
+    "markdownBlockQuote": { "dark": "owlFgDim", "light": "#94a3b8" },
+    "markdownEmph": { "dark": "owlOrange", "light": "owlOrange" },
+    "markdownStrong": { "dark": "owlYellow", "light": "owlYellow" },
+    "markdownHorizontalRule": { "dark": "owlBorder", "light": "#94a3b8" },
+    "markdownListItem": { "dark": "owlCyan", "light": "owlTeal" },
+    "markdownListEnumeration": { "dark": "owlOrange", "light": "owlOrange" },
+    "markdownImage": { "dark": "owlPurple", "light": "owlPurple" },
+    "markdownImageText": { "dark": "owlPink", "light": "owlPink" },
+    "markdownCodeBlock": { "dark": "owlFg", "light": "owlBg" },
+    "syntaxComment": { "dark": "owlFgDim", "light": "#94a3b8" },
+    "syntaxKeyword": { "dark": "owlPurple", "light": "owlPurple" },
+    "syntaxFunction": { "dark": "owlCyan", "light": "owlTeal" },
+    "syntaxVariable": { "dark": "owlOrange", "light": "owlOrange" },
+    "syntaxString": { "dark": "owlGreen", "light": "owlGreen" },
+    "syntaxNumber": { "dark": "owlYellow", "light": "owlYellow" },
+    "syntaxType": { "dark": "owlBlue", "light": "owlBlue" },
+    "syntaxOperator": { "dark": "owlPink", "light": "owlPink" },
+    "syntaxPunctuation": { "dark": "owlFg", "light": "#1e293b" },
+    "syntaxConstant": { "dark": "owlPurple", "light": "owlPurple" },
+    "syntaxBuiltin": { "dark": "owlCyan", "light": "owlTeal" },
+    "syntaxProperty": { "dark": "owlBlue", "light": "owlBlue" },
+    "syntaxMethod": { "dark": "owlCyan", "light": "owlTeal" },
+    "syntaxTag": { "dark": "owlRed", "light": "owlRed" },
+    "syntaxAttribute": { "dark": "owlOrange", "light": "owlOrange" },
+    "syntaxRegexp": { "dark": "owlPink", "light": "owlPink" },
+    "syntaxNamespace": { "dark": "owlYellow", "light": "owlYellow" },
+    "syntaxParameter": { "dark": "owlOrange", "light": "owlOrange" },
+    "syntaxField": { "dark": "owlBlue", "light": "owlBlue" },
+    "syntaxBoolean": { "dark": "owlPurple", "light": "owlPurple" },
+    "syntaxSpecial": { "dark": "owlPink", "light": "owlPink" },
+    "syntaxEscapeChar": { "dark": "owlPink", "light": "owlPink" },
+    "syntaxLabel": { "dark": "owlPurple", "light": "owlPurple" },
+    "syntaxImport": { "dark": "owlCyan", "light": "owlTeal" },
+    "syntaxPreproc": { "dark": "owlOrange", "light": "owlOrange" },
+    "syntaxDiffPlus": { "dark": "owlGreen", "light": "owlGreen" },
+    "syntaxDiffMinus": { "dark": "owlRed", "light": "owlRed" },
+    "syntaxDiffLine": { "dark": "owlBlue", "light": "owlBlue" }
+  }
+}