CODITECT Research Pipeline Standard
Standard ID: CODITECT-STD-019 Version: 1.0.0 Status: Active ADR: ADR-206 (Autonomous Research Pipeline)
1. Purpose
Defines the standard for CODITECT's autonomous multi-agent research pipeline, which generates technology evaluation artifacts in parallel with dependency management and optionally hands off to /new-project for project creation.
2. Scope
This standard governs:
- Research pipeline invocation and interactive intake
- Artifact structure, naming, and quality requirements
- Multi-agent orchestration patterns and batch ordering
- Model routing decisions per artifact type
- Project genesis handoff protocol
- JSX dashboard design system compliance
3. Pipeline Phases
Phase 0: Interactive Intake
| Rule | Requirement |
|---|---|
| RP-001 | Pipeline MUST accept topic as positional argument or interactive prompt |
| RP-002 | Pipeline MUST support --urls, --github, --docs, --originals input flags |
| RP-003 | When no flags provided, pipeline MUST enter interactive mode using AskUserQuestion |
| RP-004 | All inputs MUST be validated before proceeding (URLs reachable, paths exist) |
Phase 1: Research Artifact Generation
| Rule | Requirement |
|---|---|
| RP-010 | Pipeline MUST generate all 9 standard markdown artifacts |
| RP-011 | Batch 0 (web research) MUST complete before any other batch starts |
| RP-012 | Batch 1 (core analysis) MUST complete before Batch 2 (design docs) starts |
| RP-013 | Batch 2 (design docs) and Batch 3 (reference materials) MAY run in parallel |
| RP-014 | Each artifact MUST include YAML frontmatter per CODITECT-STANDARD-DOCUMENTATION |
| RP-015 | Each artifact MUST be valid standalone markdown |
Phase 2: Visualization
| Rule | Requirement |
|---|---|
| RP-020 | Pipeline MUST generate 4 core JSX dashboards (6 if --extended) |
| RP-021 | Dashboards MUST use light mode only (backgrounds: #FFFFFF, #F8FAFC, #F1F5F9) |
| RP-022 | Dashboards MUST use Tailwind core utilities only, no custom CSS |
| RP-023 | Each dashboard MUST be a single self-contained JSX file with default export |
| RP-024 | All data MUST be inline — no external imports except React and lucide-react |
| RP-025 | Text MUST be >= #374151 contrast; body text >= 16px |
| RP-026 | Status indicators MUST use color + text label (never color alone) |
Phase 3: Ideation
| Rule | Requirement |
|---|---|
| RP-030 | Pipeline MUST generate 15-25 categorized follow-up prompts |
| RP-031 | Prompts MUST span all 6 categories: Architecture, Compliance, Multi-Agent, Competitive, Product, Risk |
| RP-032 | Each prompt MUST be self-contained with CODITECT context |
Phase 4: Project Genesis (Optional)
| Rule | Requirement |
|---|---|
| RP-040 | Genesis handoff MUST be opt-in via --genesis flag |
| RP-041 | Research artifacts MUST map to /new-project discovery input format |
| RP-042 | Genesis MUST skip the discovery interview phase (pre-populated brief) |
4. Standard Artifacts
4.1 Phase 1 Artifacts (Markdown)
| # | Artifact | Filename | Description |
|---|---|---|---|
| 1 | Quick Start | 1-2-3-detailed-quick-start.md | Dense setup guide for experienced engineers |
| 2 | CODITECT Impact | coditect-impact.md | Integration analysis for CODITECT platform |
| 3 | Executive Summary | executive-summary.md | 1-2 page decision-support document |
| 4 | System Design | sdd.md | Technology as subsystem within CODITECT |
| 5 | Technical Design | tdd.md | Concrete integration details |
| 6 | ADRs | adrs/ADR-001-*.md | 3-7 architecture decision records |
| 7 | Glossary | glossary.md | Term definitions with CODITECT equivalents |
| 8 | Mermaid Diagrams | mermaid-diagrams.md | 4+ architecture diagrams |
| 9 | C4 Architecture | c4-architecture.md | Full C4 model (Context, Container, Component, Code) |
4.2 Phase 2 Artifacts (JSX Dashboards)
| # | Dashboard | Filename | Tabs |
|---|---|---|---|
| 1 | Tech Architecture | tech-architecture-analyzer.jsx | Component Map, Integration Surface, Runtime, Gap Analysis |
| 2 | Strategic Fit | strategic-fit-dashboard.jsx | Competitive, Build/Buy/Integrate, Trajectory, Risks |
| 3 | Integration Playbook | coditect-integration-playbook.jsx | Architecture, Compliance, Migration, ADRs |
| 4 | Executive Brief | executive-decision-brief.jsx | Summary, Investment, Readiness, Recommendation |
| 5 | Competitive (ext) | competitive-comparison.jsx | Feature comparison, scoring, fit radar |
| 6 | Implementation (ext) | implementation-planner.jsx | WBS, skills, timeline, success criteria |
4.3 Phase 3 Artifact
| # | Artifact | Filename |
|---|---|---|
| 1 | Follow-up Prompts | follow-up-prompts.md |
4.4 Pipeline Metadata
| # | Artifact | Filename |
|---|---|---|
| 1 | Index | README.md |
| 2 | Research Context | research-context.json |
| 3 | Pipeline Report | pipeline-report.json |
5. Output Directory Structure
{output-dir}/
├── README.md
├── research-context.json
├── pipeline-report.json
├── 1-2-3-detailed-quick-start.md
├── coditect-impact.md
├── executive-summary.md
├── sdd.md
├── tdd.md
├── c4-architecture.md
├── glossary.md
├── mermaid-diagrams.md
├── follow-up-prompts.md
├── adrs/
│ ├── ADR-001-*.md
│ └── ...
└── dashboards/
├── tech-architecture-analyzer.jsx
├── strategic-fit-dashboard.jsx
├── coditect-integration-playbook.jsx
├── executive-decision-brief.jsx
├── competitive-comparison.jsx # --extended only
└── implementation-planner.jsx # --extended only
6. Model Routing
| Agent | Default Model | Override Condition | Override Model |
|---|---|---|---|
| Web Research | Sonnet | — | — |
| Quick Start Generator | Haiku | — | — |
| Impact Analyzer | Sonnet | Healthcare/Fintech domain | Opus |
| Executive Summary Writer | Sonnet | Board-level audience | Opus |
| SDD Generator | Sonnet | Compliance-critical | Opus |
| TDD Generator | Sonnet | — | — |
| C4 Modeler | Sonnet | — | — |
| ADR Generator | Sonnet | Compliance ADRs | Opus |
| Glossary Builder | Haiku | — | — |
| Mermaid Creator | Haiku | — | — |
| Dashboard Generator | Sonnet | — | — |
| Ideation Generator | Sonnet | — | — |
| Quality Validator | Sonnet | — | — |
7. Quality Requirements
| Metric | Threshold | Action on Failure |
|---|---|---|
| Artifact completeness | All 9 markdown + 4 JSX minimum | Retry failed agents |
| Artifact quality score | >= 70% per CODITECT QA grading | Re-run with Opus |
| JSX render validation | No syntax errors | Retry with stricter constraints |
| Mermaid diagram validity | All diagrams render | Fix syntax, retry |
| Cross-reference integrity | No broken internal links | Aggregator validates |
| CODITECT context | Every artifact references CODITECT | Quality validator checks |
8. Error Handling
| Failure | Strategy | Fallback |
|---|---|---|
| Web research timeout | Proceed with available data | Flag gaps in README |
| Artifact agent fails | Retry once with Opus | Continue without, log gap |
| Quality gate fails | Re-run failed artifacts | Accept with quality warning |
| JSX validation fails | Retry with stricter constraints | Manual fix suggestion |
| Genesis handoff fails | Save artifacts | Provide manual handoff guide |
9. Compliance
This standard is governed by:
- ADR-206 — Autonomous Research Pipeline architecture
- CODITECT-STANDARD-AUTOMATION — Execution principles
- CODITECT-STANDARD-DOCUMENTATION — Frontmatter and structure
- CODITECT-STANDARD-TRACK-NOMENCLATURE — Task ID protocol
Author: Hal Casteel, CEO/CTO AZ1.AI Inc. Owner: AZ1.AI INC Created: 2026-02-16
Copyright 2026 AZ1.AI Inc.