agent-os-framework

name	agent-os-framework
description	Generate standardized .agent-os directory structure with product documentation, mission, tech-stack, roadmap, and decision records. Enables AI-native workflows.
version	1.0.0
category	workspace-hub
type	skill
trigger	manual
auto_execute	false
capabilities	["product_documentation","mission_definition","tech_stack_documentation","roadmap_planning","decision_records"]
tools	["Write","Read","Bash"]
related_skills	["repo-readiness","python-project-template"]

Agent OS Framework

Generate standardized .agent-os structure for AI-native repository workflows.

Quick Start

# Generate full .agent-os structure
/agent-os-framework

# Generate for existing project
/agent-os-framework --update

# Generate specific component
/agent-os-framework --component mission

When to Use

USE when:

• Setting up new repository
• Adding AI workflow support
• Documenting product vision
• Creating decision records

DON'T USE when:

• Project has complete .agent-os
• Non-product repositories (e.g., dotfiles)

Prerequisites

• Repository initialized with git
• Basic project understanding
• Stakeholder input for mission

Overview

Creates complete .agent-os structure:

1. product/ - Core product documentation
2. specs/ - Feature specifications
3. standards/ - Code style guidelines
4. instructions/ - Workflow instructions

Directory Structure

.agent-os/
├── product/
│   ├── mission.md        # Product pitch, users, pain points
│   ├── tech-stack.md     # Technology choices
│   ├── roadmap.md        # Development phases
│   └── decisions.md      # Decision log
├── specs/
│   └── README.md         # Spec index
├── standards/
│   ├── code-style.md     # Coding guidelines
│   └── testing.md        # Testing guidelines
└── instructions/
    ├── create-spec.md    # How to create specs
    └── execute-tasks.md  # How to execute tasks

Core Templates

1. mission.md

# Mission: [Project Name]

> [One-line pitch describing the project's core purpose]

## Product Pitch

[2-3 paragraph description of what the product does, why it exists, and what problem it solves]

## Target Users

### Primary Users
- **[User Type 1]**: [Description and needs]
- **[User Type 2]**: [Description and needs]


 : [Description and needs]




 : [Description of the problem]
 : [Description of the problem]
 : [Description of the problem]


 : [How this product solves the problem]
 : [How this product solves the problem]
 : [How this product solves the problem]



| Metric | Current | Target | Timeframe |
|--------|---------|--------|-----------|
| [Metric 1] | [Current value] | [Target value] | [When] |
| [Metric 2] | [Current value] | [Target value] | [When] |
| [Metric 3] | [Current value] | [Target value] | [When] |




 : [Description]
 : [Description]
 : [Description]


 : [How we differ]
 : [How we differ]



Things explicitly out of scope:
 [Non-goal 1]
 [Non-goal 2]
 [Non-goal 3]

---