skill-builder

AIWG is a cognitive architecture that provides AI coding assistants with structured memory, ensemble validation, and closed-loop self-correction. Unlike simple prompt libraries or ad-hoc workflows, AIWG implements research-backed patterns for multi-agent coordination, reproducible execution, and FAIR-aligned artifact management. The system addresses fundamental challenges in AI-augmented development: recovery from failures, maintaining context across sessions, preventing hallucinated citations, and ensuring workflow reproducibility. These capabilities position AIWG closer to cognitive architectures like SOAR and ACT-R, adapted for large language model orchestration, than to conventional AI development tools.

---

For Practitioners

Turn unpredictable AI assistance into reliable, auditable workflows. Research shows 47% of AI workflows produce inconsistent results without reproducibility constraints. AIWG implements closed-loop self-correction, human-in-the-loop validation (reducing costs by 84%), and retrieval-first citation architecture (eliminating the 56% hallucination rate of generation-only approaches). The .aiwg/ artifact directory provides persistent memory across sessions, ensuring context isn't lost when your AI assistant restarts.

For Researchers

Standards-aligned implementation of multi-agent systems and reproducibility frameworks. AIWG operationalizes FAIR Principles (endorsed by G20, EU, NIH), implements OAIS-inspired archival lifecycles (ISO 14721), and uses W3C PROV for provenance tracking. The framework provides a testbed for studying human-AI collaboration patterns, ensemble validation effectiveness, and cognitive load optimization in AI-augmented workflows. All artifacts are structured for analysis and citation export.

For Executives

Risk reduction through governance-ready AI workflows. AIWG provides audit trails (W3C PROV provenance chains), quality gates (GRADE-style evidence assessment), and deterministic execution modes. The system implements stage-gate processes familiar from Cooper's methodology, ensuring predictable phase transitions and milestone tracking. Standards adopted by 100+ organizations (WHO, Cochrane, NICE) back the quality assessment approach. Human validation checkpoints ensure AI outputs meet enterprise quality standards before production deployment.

---

AIWG's architecture is informed by established research across cognitive science, software engineering, and AI systems. The cognitive load optimization follows Miller's "7±2" limits and Sweller's worked examples approach. Multi-agent ensemble validation implements mixture-of-experts patterns from Jacobs et al. The closed-loop self-correction design addresses the finding that recovery capability—not initial correctness—dominates agentic task success. Research management implements FAIR Principles with 17,000+ citations and institutional backing from G20, EU Horizon 2020, and NIH. The retrieval-first citation architecture eliminates hallucination by grounding all references in verified sources rather than generative recall.

Full research background, citations, and methodology available in [docs/research/](docs/research/).

---

1. Structured Semantic Memory

Persistent artifact repository (.aiwg/) maintaining project knowledge across sessions. Implements retrieval-augmented generation patterns to prevent context loss when AI assistants restart or hit token limits.

2. Multi-Agent Ensemble Validation

Specialized agents (Test Engineer, Security Auditor, API Designer) provide domain expertise with coordinated review and synthesis. Mixture-of-experts architecture enables parallel evaluation and quality gates.

3. Closed-Loop Self-Correction

Ralph loop implements iterative execution with automatic error recovery. Research shows recovery capability is more important than initial correctness for agentic task success. Supports both short sessions (minutes) and long-running operations (6-8 hours with crash recovery).

4. Bidirectional Traceability

@-mention system links requirements, architecture, implementation, and tests. Enables impact analysis, compliance auditing, and change propagation tracking per IEEE 830 and DO-178C standards.

5. Stage-Gate Process Management

Phase-gated workflows (Inception → Elaboration → Construction → Transition → Production) with milestone tracking and quality checkpoints. Implements Cooper's stage-gate methodology adapted for AI-augmented development.

6. FAIR-Aligned Artifact Management

Research corpus management with persistent identifiers (REF-XXX system), W3C PROV provenance tracking, and GRADE-style quality assessment. Ensures findable, accessible, interoperable, and reusable project artifacts.

---

> Prerequisites: Node.js ≥18.0.0 and an AI platform (Claude Code, GitHub Copilot, Warp Terminal, or others). See [Prerequisites Guide](docs/getting-started/prerequisites.md) for details.

Install & Deploy

```bash

# Install globally

npm install -g aiwg

# Deploy to your project

cd your-project

aiwg use sdlc # Full SDLC framework

aiwg use marketing # Marketing framework

aiwg use all # All frameworks

# Or scaffold a new project

aiwg new my-project

```

Claude Code Plugin (Alternative)

```bash

/plugin marketplace add jmagly/ai-writing-guide

/plugin install sdlc@aiwg

```

> Platform options: --provider warp, --provider factory, --provider cursor, --provider copilot. See [Platform Integration](docs/integrations/) for details.

---

Frameworks

| Framework | What it does |

|-----------|--------------|

| [SDLC Complete](agentic/code/frameworks/sdlc-complete/) | Full software development lifecycle with agents, commands, templates, and multi-agent orchestration |

| [Media/Marketing Kit](agentic/code/frameworks/media-marketing-kit/) | Complete marketing campaign management from strategy to analytics |

Addons

| Addon | What it does |

|-------|--------------|

| [Writing Quality](agentic/code/addons/writing-quality/) | Content validation, AI pattern detection, voice profiles |

| [Testing Quality](agentic/code/addons/testing-quality/) | TDD enforcement, mutation testing, flaky test detection |

| [Voice Framework](agentic/code/addons/voice-framework/) | 4 built-in voice profiles with create/blend/apply skills |

Reliability Patterns

• [Ralph Loop](docs/ralph-guide.md) — Iterative task execution with automatic recovery
• [Agent Design Bible](docs/AGENT-DESIGN.md) — 10 Golden Rules based on academic research
• [@-Mention Traceability](docs/mention-utilities.md) — Wire live doc refe