Skills + Development Frameworks

[TerminallyLazy]

Summary

• Add development framework system allowing users to select structured workflows (GSD, Superpowers, BMAD, Spec Kit, PRP, AgentOS, AMPLIHACK)
• Implement 36 framework-specific workflow skills that guide agents through established methodologies
• Enable per-project framework override alongside global default setting
• Move Skills Import to dedicated Settings tab for better organization

Motivation

Development frameworks like GSD (Get Stuff Done), BMAD, and Superpowers provide structured methodologies that help developers work more effectively with AI agents. Previously, users had to manually prompt the agent with framework-specific instructions or rely on generic responses.

This PR integrates framework awareness directly into Agent Zero, allowing the agent to:

• Automatically prioritize framework-specific skills when working on projects
• Provide contextual workflow guidance in system prompts
• Offer consistent, methodology-driven assistance

Features

Framework Selection (Global)

Users can select a default development framework in Settings > Agent > Framework:

• Dropdown with 7 supported frameworks
• "View Details" button opens modal showing:
  • Framework description
  • Workflow steps with descriptions
  • Visual workflow diagram

Project-Level Override

Each project can override the global framework in Projects > Edit > Development Framework:

• "Use Global Setting" (default) inherits from global settings
• Or select a specific framework for that project
• Useful for teams using different methodologies per project

Framework-Aware Skill Discovery

When a framework is active:

• Framework skills are prioritized in skill search results
• skills_tool passes framework_id to all skill helper functions
• Skill recall extension includes framework context

System Prompt Integration

Active framework context is injected into the agent's system prompt:

• Framework name and description
• Numbered workflow steps
• Guidance to use appropriate skills for each step

Skills Tab in Settings

Skills Import functionality moved from Agent settings to dedicated Settings > Skills tab for better organization and future expansion.

Supported Frameworks

Framework	Skills	Primary Use Case
GSD (Get Stuff Done)	6	Rapid iteration with discuss→plan→execute→verify cycle
Superpowers	7	Claude Code workflows: brainstorming, planning, TDD, git worktrees
BMAD	8	Full product lifecycle: briefs→PRDs→architecture→epics→stories
Spec Kit	5	Specification-driven: constitution→specify→plan→tasks→implement
PRP	2	Prompt-Response-Prompt pattern for complex tasks
AgentOS	2	Project scaffolding and standards enforcement
AMPLIHACK	6	Multi-agent orchestration: analyze, debate, cascade, fix

Architecture

  │                    Framework Selection Flow                      │                                                                                                                                                                                                          
  ├─────────────────────────────────────────────────────────────────┤                                                                                                                                                                                                           
  │  Settings (Global Default)  →  Project Override (Optional)       │                                                                                                                                                                                                          
  │         ↓                              ↓                         │                                                                                                                                                                                                          
  │  dev_framework: "gsd"       .a0proj/project.json                │                                                                                                                                                                                                           
  │                              dev_framework: "bmad"               │                                                                                                                                                                                                          
  ├─────────────────────────────────────────────────────────────────┤                                                                                                                                                                                                           
  │                    Skill Discovery                               │                                                                                                                                                                                                          
  │  skills/frameworks/{active_framework}/ takes priority            │                                                                                                                                                                                                          
  │  Then: custom/ → builtin/ → shared/                             │                                                                                                                                                                                                           
  ├─────────────────────────────────────────────────────────────────┤                                                                                                                                                                                                           
  │                    System Prompt Injection                       │                                                                                                                                                                                                          
  │  Framework context + workflow steps injected into agent prompt   │                                                                                                                                                                                                          
  └─────────────────────────────────────────────────────────────────┘                                                                                                                                                                                                           

File Changes

Backend - Core

File	Change
python/helpers/frameworks.py	NEW - Framework registry with dataclasses and utilities
python/api/frameworks.py	NEW - API endpoint for list/get framework operations
python/helpers/settings.py	Add dev_framework field to Settings TypedDict
python/helpers/projects.py	Add dev_framework to BasicProjectData
python/helpers/skills.py	Framework-aware get_skill_roots() function

Backend - Extensions

File	Change
python/tools/skills_tool.py	Pass framework_id to all skill helper calls
python/extensions/message_loop_prompts_after/_55_recall_skills.py	Include framework context in skill recall
python/extensions/system_prompt/_10_system_prompt.py	Inject framework prompt when active

Backend - Prompts

File	Change
prompts/agent.system.framework.md	NEW - Framework context template

Frontend - Settings

File	Change
webui/components/settings/settings.html	Add Skills tab to navigation
webui/components/settings/agent/agent-settings.html	Remove Skills section (moved to own tab)
webui/components/settings/agent/framework.html	NEW - Framework selector component
webui/components/settings/frameworks/framework-details.html	NEW - Framework details modal
webui/components/settings/frameworks/framework-store.js	NEW - Alpine store for frameworks
webui/components/settings/skills/skills-settings.html	NEW - Skills tab wrapper

Frontend - Projects

File	Change
webui/components/projects/project-edit-basic-data.html	Add framework dropdown
webui/components/projects/projects-store.js	Add frameworkOptions and loadFrameworkOptions()

Frontend - Assets

File	Change
webui/public/framework.svg	NEW - Framework icon for settings nav

Skills

Directory	Count	Description
skills/frameworks/gsd/	6	GSD workflow skills
skills/frameworks/superpowers/	7	Superpowers workflow skills
skills/frameworks/bmad/	8	BMAD workflow skills
skills/frameworks/speckit/	5	Spec Kit workflow skills
skills/frameworks/prp/	2	PRP workflow skills
skills/frameworks/agentos/	2	AgentOS workflow skills
skills/frameworks/amplihack/	6	AMPLIHACK workflow skills

API Changes

New Endpoint: /api/frameworks

Request:

{ "action": "list" }

Response:

  {                                                                                                                                                                                                                                                                             
    "ok": true,                                                                                                                                                                                                                                                                 
    "data": [                                                                                                                                                                                                                                                                   
      {                                                                                                                                                                                                                                                                         
        "id": "gsd",                                                                                                                                                                                                                                                            
        "name": "GSD (Get Stuff Done)",                                                                                                                                                                                                                                         
        "description": "A rapid iteration framework...",                                                                                                                                                                                                                        
        "skill_prefix": "gsd",                                                                                                                                                                                                                                                  
        "workflows": [                                                                                                                                                                                                                                                          
          { "name": "Discuss Phase", "skill_name": "gsd-discuss-phase", "description": "...", "sequence": 1 }                                                                                                                                                                   
        ]                                                                                                                                                                                                                                                                       
      }                                                                                                                                                                                                                                                                         
    ]                                                                                                                                                                                                                                                                           
  }                                                                                                                                                                                                                                                                             

Breaking Changes

None. This is a purely additive feature:

• Default dev_framework is "none" (no framework active)
• Existing projects without dev_framework field default to using global setting
• Skills Import functionality preserved (just relocated to own tab)

Test Plan

Settings - Framework Selection

• Open Settings > Agent and verify "Framework" section appears
• Verify dropdown contains: None, GSD, Superpowers, BMAD, Spec Kit, PRP, AgentOS, AMPLIHACK
• Select a framework and save settings
• Reopen settings and verify selection persisted
• Click "View Details" button and verify modal opens with correct framework info

Settings - Skills Tab

• Open Settings and verify "Skills" tab appears in navigation
• Click Skills tab and verify Import Skills section displays
• Test import functionality works as before

Projects - Framework Override

• Create a new project and verify "Development Framework" dropdown appears
• Verify dropdown shows "Use Global Setting" as first option
• Select a framework override and save
• Reopen project edit and verify selection persisted
• Edit existing project and verify dropdown appears with current value

Agent Behavior

• Set global framework to "GSD"
• Start new conversation and ask "Help me start a new project"
• Verify agent mentions GSD methodology and suggests relevant skills
• Create project with BMAD override
• Activate project and verify agent uses BMAD context instead

Skill Discovery

• With GSD framework active, run skill search
• Verify GSD skills appear prioritized in results
• Change to BMAD framework
• Verify BMAD skills now appear prioritized

Edge Cases

• Set framework to "None" and verify no framework context in prompts
• Create project with override, then change global - verify project still uses override
• Test with project set to "Use Global Setting" inherits correctly

[diegohb]

super excited for these enhancements.. but is this still being actively maintained/developed ? There's no commits to main for a while ?

[TerminallyLazy]

We work mostly from the development branch-- main will recieve only fully tested and polished commits. But hang in there, we have a big one coming very soon.

[diegohb]

To be clear, for GSD.. you do mean this one right? https://github.com/glittercowboy/get-shit-done

[TerminallyLazy]

Yup