Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ Once you've initialized the spec folder, output the following message (replace `
```
✅ I have initialized the spec folder at `agent-os/specs/[this-spec]`.

NEXT STEP 👉 Run the command, 2-research-spec.md
NEXT STEP 👉 Run the command, 2-shape-spec.md
```
{{ENDUNLESS compiled_single_command}}
13 changes: 3 additions & 10 deletions profiles/default/commands/shape-spec/single-agent/2-shape-spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,24 +9,17 @@ Follow these instructions for researching this spec's requirements:
Once you've completed your research and documented it, output the following message:

```
✅ I have documented this spec's research and requirements in `agent-os/specs/[this-spec]/planning`.

Next step: Run the command, `1-create-spec.md`.
```

After all steps complete, inform the user:

```
Spec initialized successfully!
Spec shaping is complete!

✅ Spec folder created: `[spec-path]`
✅ Requirements gathered
✅ Visual assets: [Found X files / No files provided]

👉 Run `/write-spec` to create the spec.md document.
👉 Run the command `/write-spec` to create the spec.md document.
```

{{UNLESS standards_as_claude_code_skills}}

## User Standards & Preferences Compliance

IMPORTANT: Ensure that your research questions and insights are ALIGNED and DOES NOT CONFLICT with the user's preferences and standards as detailed in the following files:
Expand Down
34 changes: 14 additions & 20 deletions profiles/default/workflows/specification/initialize-spec.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,15 @@

## Core Responsibilities

1. **Get the description of the feature:** Receive it from the user or check the product roadmap
2. **Initialize Spec Structure**: Create the spec folder with date prefix
3. **Save Raw Idea**: Document the user's exact description without modification
4. **Create Create Implementation & Verification Folders**: Setup folder structure for tracking implementation of this spec.
5. **Prepare for Requirements**: Set up structure for next phase
1. **Get the description of the feature:** Check the product roadmap or get it from the user
2. **Initialize spec structure**: Create the feature spec folder with date prefix
3. **Create spec folders**: Setup folder structure for tracking planning, implementation and verification of this feature spec

## Workflow

### Step 1: Get the description of the feature

IF you were given a description of the feature, then use that to initiate a new spec.
IF you were given a description of the feature, then use that to initialize a new feature spec.

OTHERWISE follow these steps to get the description:

Expand All @@ -23,20 +21,20 @@ OTHERWISE follow these steps to get the description:
Which feature would you like to initiate a new spec for?

- The roadmap shows [feature description] is next. Go with that?
- Or provide a description of a feature you'd like to initiate a spec for.
- Or provide a description of a feature you'd like to initiate a spec for
```

**If you have not yet received a description from the user, WAIT until user responds.**

### Step 2: Initialize Spec Structure
### Step 2: Initialize spec structure

Determine a kebab-case spec name from the user's description, then create the spec folder:
Determine a kebab-case spec name from the feature description, then create the spec folder:

```bash
# Get today's date in YYYY-MM-DD format
TODAY=$(date +%Y-%m-%d)

# Determine kebab-case spec name from user's description
# Determine kebab-case spec name from the feature description
SPEC_NAME="[kebab-case-name]"

# Create dated folder name
Expand All @@ -48,18 +46,13 @@ SPEC_PATH="agent-os/specs/$DATED_SPEC_NAME"
# Create folder structure following architecture
mkdir -p $SPEC_PATH/planning
mkdir -p $SPEC_PATH/planning/visuals
mkdir -p $SPEC_PATH/implementation
mkdir -p $SPEC_PATH/verification

echo "Created spec folder: $SPEC_PATH"
```

### Step 3: Create Implementation Folder

Create 2 folders:
- `$SPEC_PATH/implementation/`

Leave this folder empty, for now. Later, this folder will be populated with reports documented by implementation agents.

### Step 4: Output Confirmation
### Step 4: Output confirmation

Return or output the following:

Expand All @@ -70,11 +63,12 @@ Structure created:
- planning/ - For requirements and specifications
- planning/visuals/ - For mockups and screenshots
- implementation/ - For implementation documentation
- verification/ - For verification documentation

Ready for requirements research phase.
Ready for requirements research phase...
```

## Important Constraints
## Important constraints

- Always use dated folder names (YYYY-MM-DD-spec-name)
- Pass the exact spec path back to the orchestrator
Expand Down