Create AIWG Framework

Create a new AIWG framework with complete lifecycle structure.

Process

1. Validate Framework Name

Check that $ARGUMENTS contains a valid framework name:

Must be kebab-case (lowercase with hyphens)
Must not conflict with existing frameworks

Check existing frameworks:

ls ~/.local/share/ai-writing-guide/agentic/code/frameworks/

2. Interactive Design (if --interactive)

If --interactive is specified, guide the user through framework design:

Framework Purpose:

What lifecycle does this framework manage? (e.g., software development, marketing campaigns, legal cases)

Target Audience:

Who will use this framework? (e.g., development teams, marketing departments, legal firms)

Phase Structure:

What phases does this lifecycle include? Default: inception, elaboration, construction, transition Custom examples: discovery, analysis, synthesis, publication

Agent Categories:

What types of roles are needed?

Analysis roles (analysts, researchers)

Design roles (architects, designers)

Implementation roles (developers, writers)

Quality roles (reviewers, testers)

Management roles (coordinators, managers)

Template Categories:

What artifact types will be produced?

Planning documents

Requirements documents

Design documents

Implementation artifacts

Quality artifacts

Deployment artifacts

3. Execute Scaffolding

Run the CLI scaffolding tool:

node ~/.local/share/ai-writing-guide/tools/scaffolding/scaffold-framework.mjs \
  <name> \
  --description "<derived from interactive>" \
  --phases "<phase1,phase2,...>"

4. Post-Creation Guidance

After scaffolding, provide guidance on next steps:

Immediate Actions:

Review and customize actors-and-templates.md
Define your first agents for each phase
Create initial templates for key artifacts

Agent Creation Priority:

Phase 1: Create 2-3 core agents per phase
Phase 2: Add specialized agents as needed
Phase 3: Add orchestration agents for workflows

Command Creation Priority:

Phase 1: Create phase execution commands (flow-<phase>)
Phase 2: Create transition commands (flow-<phase>-to-<next>)
Phase 3: Create utility commands (status, validation)

Template Creation Priority:

Phase 1: Create 2-3 key templates per phase
Phase 2: Add specialized templates
Phase 3: Create cross-cutting templates

5. Provide Reference Resources

Point to existing frameworks as examples:

sdlc-complete: 53 agents, 48 commands, comprehensive lifecycle
media-marketing-kit: 37 agents, marketing-focused lifecycle

Reference documentation:

docs/development/framework-creation-guide.md
docs/development/devkit-overview.md

Output Format

Framework Created: <name>
─────────────────────────

Location: ~/.local/share/ai-writing-guide/agentic/code/frameworks/<name>/

Phases: <phase1> → <phase2> → ... → <phaseN>

Created:
  ✓ manifest.json
  ✓ README.md
  ✓ plan-act-<name>.md
  ✓ actors-and-templates.md
  ✓ agents/manifest.md
  ✓ commands/manifest.md
  ✓ templates/manifest.json
  ✓ flows/<phase>.md (for each phase)
  ✓ metrics/tracking-catalog.md
  ✓ config/models.json

Next Steps:
  1. Define actors: Edit actors-and-templates.md
  2. Add agents:    aiwg add-agent <name> --to <framework>
  3. Add commands:  aiwg add-command <name> --to <framework>
  4. Add templates: aiwg add-template <name> --to <framework> --category <phase>
  5. Deploy:        aiwg use <framework>

Notes

Framework creation is a significant undertaking (50+ agents typical)
Study existing frameworks before creating new ones
Use --interactive for guided design process
Start small and iterate (core agents first, then expand)

References

@$AIWG_ROOT/agentic/code/addons/aiwg-dev/README.md — aiwg-dev addon overview
@$AIWG_ROOT/docs/extensions/overview.md — Extension system architecture
@$AIWG_ROOT/docs/cli-reference.md — CLI reference including scaffold-framework command
@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework as reference implementation
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/god-session.md — Scope guidelines for agent design within frameworks