Devkit Create Framework

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:

1. Review and customize actors-and-templates.md
2. Define your first agents for each phase
3. 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