bmad-studio 0.1.0

package/_bmad/tea/workflows/testarch/bmad-testarch-trace/validation-report-20260127-095021.md

@@ -0,0 +1,73 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:03:10
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 09:50:21
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 73 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 62 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 58 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 57 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 66 lines [GOOD]
+- steps-e/step-01-assess.md: 51 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 46 lines [GOOD]
+- steps-v/step-01-validate.md: 53 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+- No {project-root} hardcoded paths detected in body
+- No dead relative links detected
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- Last step steps-v/step-01-validate.md has no nextStepFile (final step OK)
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+
+## Validation Design Check
+
+- checklist.md present: YES
+- Validation steps folder (steps-v) present: YES
+
+## Instruction Style Check
+
+- All steps include STEP GOAL, MANDATORY EXECUTION RULES, EXECUTION PROTOCOLS, CONTEXT BOUNDARIES, and SUCCESS/FAILURE metrics
+
+## Summary
+
+- Validation completed: 2026-01-27 10:03:10
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/_bmad/tea/workflows/testarch/bmad-testarch-trace/validation-report-20260127-102401.md

@@ -0,0 +1,116 @@
+---
+validationDate: 2026-01-27
+workflowName: testarch-trace
+workflowPath: {project-root}/src/workflows/testarch/bmad-testarch-trace
+validationStatus: COMPLETE
+completionDate: 2026-01-27 10:24:01
+---
+
+# Validation Report: testarch-trace
+
+**Validation Started:** 2026-01-27 10:24:01
+**Validator:** BMAD Workflow Validation System (Codex)
+**Standards Version:** BMAD Workflow Standards
+
+## File Structure & Size
+
+- workflow.md present: YES
+- instructions.md present: YES
+- workflow.yaml present: YES
+- step files found: 8
+
+**Step File Sizes:**
+
+- steps-c/step-01-load-context.md: 72 lines [GOOD]
+- steps-c/step-02-discover-tests.md: 61 lines [GOOD]
+- steps-c/step-03-map-criteria.md: 57 lines [GOOD]
+- steps-c/step-04-analyze-gaps.md: 56 lines [GOOD]
+- steps-c/step-05-gate-decision.md: 65 lines [GOOD]
+- steps-e/step-01-assess.md: 50 lines [GOOD]
+- steps-e/step-02-apply-edit.md: 45 lines [GOOD]
+- steps-v/step-01-validate.md: 52 lines [GOOD]
+- workflow-plan.md present: YES
+
+## Frontmatter Validation
+
+- No frontmatter violations found
+
+## Critical Path Violations
+
+### Config Variables (Exceptions)
+
+Standard BMAD config variables treated as valid exceptions: bmb_creations_output_folder, communication_language, document_output_language, output_folder, planning_artifacts, project-root, project_name, test_artifacts, user_name
+
+- No {project-root} hardcoded paths detected in body
+
+- No dead relative links detected
+
+- No module path assumptions detected
+
+**Status:** ✅ PASS - No critical violations
+
+## Menu Handling Validation
+
+- No menu structures detected (linear step flow) [N/A]
+
+## Step Type Validation
+
+- steps-c/step-01-load-context.md: Init [PASS]
+- steps-c/step-02-discover-tests.md: Middle [PASS]
+- steps-c/step-03-map-criteria.md: Middle [PASS]
+- steps-c/step-04-analyze-gaps.md: Middle [PASS]
+- steps-c/step-05-gate-decision.md: Final [PASS]
+- Step type validation assumes linear sequence (no branching/menu). Workflow-plan.md present for reference. [INFO]
+
+## Output Format Validation
+
+- Templates present: trace-template.md
+- Steps with outputFile in frontmatter:
+  - steps-c/step-05-gate-decision.md
+  - steps-v/step-01-validate.md
+- checklist.md present: YES
+
+## Validation Design Check
+
+- Validation steps folder (steps-v) present: YES
+- Validation step(s) present: step-01-validate.md
+- Validation steps reference checklist data and auto-proceed
+
+## Instruction Style Check
+
+- Instruction style: Prescriptive (appropriate for TEA quality/compliance workflows)
+- Steps emphasize mandatory sequence, explicit success/failure metrics, and risk-based guidance
+
+## Collaborative Experience Check
+
+- Overall facilitation quality: GOOD
+- Steps use progressive prompts and clear role reinforcement; no laundry-list interrogation detected
+- Flow progression is clear and aligned to workflow goals
+
+## Subagent Optimization Opportunities
+
+- No high-priority subagent optimizations identified; workflow already uses step-file architecture
+- Pattern 1 (grep/regex): N/A for most steps
+- Pattern 2 (per-file analysis): already aligned to validation structure
+- Pattern 3 (data ops): minimal data file loads
+- Pattern 4 (parallel): optional for validation only
+
+## Cohesive Review
+
+- Overall assessment: GOOD
+- Flow is linear, goals are clear, and outputs map to TEA artifacts
+- Voice and tone consistent with Test Architect persona
+- Recommendation: READY (minor refinements optional)
+
+## Plan Quality Validation
+
+- Plan file present: workflow-plan.md
+- Planned steps found: 8 (all implemented)
+- Plan implementation status: Fully Implemented
+
+## Summary
+
+- Validation completed: 2026-01-27 10:24:01
+- Critical issues: 0
+- Warnings: 0 (informational notes only)
+- Readiness: READY (manual review optional)

package/_bmad/tea/workflows/testarch/bmad-testarch-trace/workflow-plan.md

@@ -0,0 +1,21 @@
+    # Workflow Plan: testarch-trace
+
+    ## Create Mode (steps-c)
+    - step-01-load-context.md
+
+- step-02-discover-tests.md
+- step-03-map-criteria.md
+- step-04-analyze-gaps.md
+- step-05-gate-decision.md
+
+  ## Validate Mode (steps-v)
+  - step-01-validate.md
+
+  ## Edit Mode (steps-e)
+  - step-01-assess.md
+  - step-02-apply-edit.md
+
+  ## Outputs
+  - {test_artifacts}/traceability-matrix.md
+
+- Gate decision summary (if evidence available)

package/_bmad/tea/workflows/testarch/bmad-testarch-trace/workflow.md

@@ -0,0 +1,41 @@
+---
+name: bmad-testarch-trace
+description: Generate traceability matrix and quality gate decision. Use when user says 'lets create traceability matrix' or 'I want to analyze test coverage'
+web_bundle: true
+---
+
+# Requirements Traceability & Quality Gate
+
+**Goal:** Generate requirements-to-tests traceability matrix, analyze coverage, and make quality gate decision (PASS/CONCERNS/FAIL/WAIVED)
+
+**Role:** You are the Master Test Architect.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This workflow uses **tri-modal step-file architecture**:
+
+- **Create mode (steps-c/)**: primary execution flow
+- **Validate mode (steps-v/)**: validation against checklist
+- **Edit mode (steps-e/)**: revise existing outputs
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Mode Determination
+
+"Welcome to the workflow. What would you like to do?"
+
+- **[C] Create** — Run the workflow
+- **[R] Resume** — Resume an interrupted workflow
+- **[V] Validate** — Validate existing outputs
+- **[E] Edit** — Edit existing outputs
+
+### 2. Route to First Step
+
+- **If C:** Load `steps-c/step-01-load-context.md`
+- **If R:** Load `steps-c/step-01b-resume.md`
+- **If V:** Load `steps-v/step-01-validate.md`
+- **If E:** Load `steps-e/step-01-assess.md`

package/_bmad/tea/workflows/testarch/bmad-testarch-trace/workflow.yaml

@@ -0,0 +1,56 @@
+# Test Architect workflow: bmad-testarch-trace
+name: bmad-testarch-trace
+# prettier-ignore
+description: 'Generate traceability matrix and quality gate decision. Use when the user says "lets create traceability matrix" or "I want to analyze test coverage"'
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/tea/config.yaml"
+output_folder: "{config_source}:output_folder"
+test_artifacts: "{config_source}:test_artifacts"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+
+# Workflow components
+installed_path: "."
+instructions: "./instructions.md"
+validation: "./checklist.md"
+template: "./trace-template.md"
+
+# Variables and inputs
+variables:
+  # Directory paths
+  test_dir: "{project-root}/tests" # Root test directory
+  source_dir: "{project-root}" # Source code directory (customize if needed, e.g., {project-root}/src or {project-root}/lib)
+
+  # Workflow behavior
+  coverage_levels: "e2e,api,component,unit" # Which test levels to trace
+  gate_type: "story" # story | epic | release | hotfix - determines gate scope
+  decision_mode: "deterministic" # deterministic (rule-based) | manual (team decision)
+
+# Output configuration
+default_output_file: "{test_artifacts}/traceability-matrix.md"
+
+# Required tools
+required_tools:
+  - read_file # Read story, test files, BMad artifacts
+  - write_file # Create traceability matrix, gate YAML
+  - list_files # Discover test files
+  - search_repo # Find tests by test ID, describe blocks
+  - glob # Find test files matching patterns
+
+tags:
+  - qa
+  - traceability
+  - test-architect
+  - coverage
+  - requirements
+  - gate
+  - decision
+  - release
+
+execution_hints:
+  interactive: false # Minimize prompts
+  autonomous: true # Proceed without user input unless blocked
+  iterative: true

package/bin/bmad-studio.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = join(__dirname, '..')
+const serverEntry = join(root, 'packages', 'server', 'dist', 'index.js')
+
+if (!existsSync(serverEntry)) {
+  console.error('BMAD Studio has not been built yet.')
+  console.error('Run `npm run build` from the project root first.')
+  process.exit(1)
+}
+
+const args = process.argv.slice(2)
+
+const child = spawn('node', [serverEntry, ...args], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+})
+
+child.on('close', (code) => process.exit(code ?? 0))

package/eslint.config.js

@@ -0,0 +1,38 @@
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    languageOptions: {
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/consistent-type-imports': 'error',
+    },
+  },
+  {
+    files: ['packages/client/src/**/*.{ts,tsx}'],
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+    },
+  },
+  {
+    ignores: ['**/dist/', '**/node_modules/', '.bmad-studio/'],
+  },
+)

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "bmad-studio",
+  "version": "0.1.0",
+  "description": "Browser-based admin interface for BMAD agentic engineering framework — visualize, configure, and manage your BMAD project",
+  "type": "module",
+  "workspaces": [
+    "packages/shared",
+    "packages/server",
+    "packages/client"
+  ],
+  "bin": {
+    "bmad-studio": "./bin/bmad-studio.mjs"
+  },
+  "scripts": {
+    "dev": "concurrently -n server,client -c blue,green \"npm run dev -w @bmad-studio/server\" \"npm run dev -w @bmad-studio/client\"",
+    "build": "npm run build -w @bmad-studio/shared && npm run build -w @bmad-studio/client && npm run build -w @bmad-studio/server",
+    "start": "node packages/server/dist/index.js",
+    "test": "vitest run",
+    "lint": "eslint packages/*/src/",
+    "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\""
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "concurrently": "^9.1.2",
+    "eslint": "^9.25.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "prettier": "^3.5.3",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.31.0",
+    "vitest": "^3.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jwhiteside/bmad-studio.git"
+  },
+  "homepage": "https://github.com/jwhiteside/bmad-studio#readme",
+  "bugs": {
+    "url": "https://github.com/jwhiteside/bmad-studio/issues"
+  },
+  "keywords": [
+    "bmad",
+    "ai-agents",
+    "agentic-engineering",
+    "workflow",
+    "admin",
+    "studio",
+    "configuration",
+    "visualization"
+  ],
+  "author": "Jonathan Whiteside",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT"
+}

package/packages/client/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>BMAD Studio</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/packages/client/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@bmad-studio/client",
+  "version": "0.1.0",
+  "description": "BMAD Studio client — React SPA",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@bmad-studio/shared": "*",
+    "@codemirror/commands": "^6.10.3",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-yaml": "^6.1.2",
+    "@codemirror/language": "^6.12.2",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.40.0",
+    "@dnd-kit/react": "^0.3.2",
+    "@fontsource/inter-tight": "^5.2.7",
+    "@tanstack/react-query": "^5.91.2",
+    "@xyflow/react": "^12.10.1",
+    "lucide-react": "^0.577.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-markdown": "^10.1.0",
+    "react-router-dom": "^7.13.1",
+    "zustand": "^5.0.12"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.4",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
+    "@vitejs/plugin-react": "^4.4.1",
+    "tailwindcss": "^4.1.4",
+    "typescript": "~5.8.3",
+    "vite": "^6.3.2"
+  },
+  "license": "MIT"
+}

package/packages/client/src/app.tsx

@@ -0,0 +1,57 @@
+import { BrowserRouter, Routes, Route } from 'react-router-dom'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+
+import { NotificationProvider } from './layout/NotificationProvider.js'
+import { AppShell } from './layout/AppShell.js'
+import { OverviewPage } from './features/overview/OverviewPage.js'
+import { AgentsPage } from './features/agents/AgentsPage.js'
+import { AgentDetailPage } from './features/agents/AgentDetail.js'
+import { AgentOverrideEditor } from './features/agents/AgentOverrideEditor.js'
+import { TeamsPage } from './features/teams/TeamsPage.js'
+import { SkillsPage } from './features/skills/SkillsPage.js'
+import { WorkflowsPage } from './features/workflows/WorkflowsPage.js'
+import { OutputsPage } from './features/outputs/OutputsPage.js'
+import { ConnectionsPage } from './features/connections/ConnectionsPage.js'
+import { WorkspacePage } from './features/workspace/WorkspacePage.js'
+import { ModulesPage } from './features/packages/PackagesPage.js'
+import { FilesPage } from './features/files/FilesPage.js'
+import { SettingsPage } from './features/settings/SettingsPage.js'
+import { AboutPage } from './features/about/AboutPage.js'
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 30_000,
+      retry: 1,
+    },
+  },
+})
+
+export function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <NotificationProvider>
+        <BrowserRouter>
+          <Routes>
+            <Route element={<AppShell />}>
+              <Route index element={<OverviewPage />} />
+              <Route path="agents" element={<AgentsPage />} />
+              <Route path="agents/:id" element={<AgentDetailPage />} />
+              <Route path="agents/:id/override" element={<AgentOverrideEditor />} />
+              <Route path="teams" element={<TeamsPage />} />
+              <Route path="skills" element={<SkillsPage />} />
+              <Route path="workflows" element={<WorkflowsPage />} />
+              <Route path="outputs" element={<OutputsPage />} />
+              <Route path="connections" element={<ConnectionsPage />} />
+              <Route path="workspace" element={<WorkspacePage />} />
+              <Route path="modules" element={<ModulesPage />} />
+              <Route path="files" element={<FilesPage />} />
+              <Route path="settings" element={<SettingsPage />} />
+              <Route path="about" element={<AboutPage />} />
+            </Route>
+          </Routes>
+        </BrowserRouter>
+      </NotificationProvider>
+    </QueryClientProvider>
+  )
+}