specsmd 0.0.1 → 0.0.3

package/README.md

@@ -9,61 +9,15 @@ specsmd implements the [AI-Driven Development Lifecycle (AI-DLC)](https://aws.am
 
 ---
 
-## What is AI-DLC?
-
-AI-DLC is a reimagined software development methodology where **AI drives the conversation** and humans validate. Unlike traditional Agile where iterations span weeks, AI-DLC operates in **Bolts** - rapid iterations measured in hours or days.
-
-> "Traditional development methods were built for human-driven, long-running processes. AI-DLC reimagines the development lifecycle with AI as a central collaborator, enabling rapid cycles measured in hours or days rather than weeks."
-
-### AI-DLC vs Traditional Methods
-
-| Aspect | Agile/Scrum | AI-DLC |
-|--------|-------------|--------|
-| Iteration duration | Weeks (Sprints) | Hours/days (Bolts) |
-| Who drives | Human-driven, AI assists | AI-driven, human-validated |
-| Design techniques | Out of scope | Integrated (DDD, TDD, BDD) |
-| Task decomposition | Manual | AI-powered |
-| Phases | Repeating sprints | Rapid three-phase cycles (Inception → Construction → Operations) |
-| Rituals | Daily standups, retrospectives | Mob Elaboration, Mob Construction |
-
----
-
-## How It Works
-
-specsmd provides four specialized agents that guide you through the entire development lifecycle:
-
-```
-                    ┌─────────────────┐
-                    │  Master Agent   │  Orchestrates & navigates
-                    └────────┬────────┘
-                             │
-        ┌────────────────────┼────────────────────┐
-        ▼                    ▼                    ▼
-┌───────────────┐   ┌───────────────┐   ┌───────────────┐
-│   Inception   │ → │ Construction  │ → │  Operations   │
-│     Agent     │   │     Agent     │   │     Agent     │
-└───────────────┘   └───────────────┘   └───────────────┘
-  Capture intent      Execute bolts      Deploy & monitor
-  Define units        Build & test       Verify & scale
-  Plan stories        Validate stages
-```
-
-### The Three Phases
-
-| Phase | Agent | Purpose | Key Outputs |
-|-------|-------|---------|-------------|
-| **Inception** | Inception Agent | Capture intents, elaborate requirements, decompose into units | User stories, NFRs, Unit definitions, Bolt plans |
-| **Construction** | Construction Agent | Execute bolts through domain design → logical design → code → test | Domain models, Technical designs, Code, Tests |
-| **Operations** | Operations Agent | Deploy, verify, and monitor | Deployment units, Monitoring, Runbooks |
-
----
-
 ## Quick Start
 
 ### Installation
 
+> [!NOTE]
+> Do not use npm if you want to always get the latest version. Use the npx command below. 
+
 ```bash
-npx specsmd install
+npx specsmd@latest install
 ```
 
 The installer detects your AI coding tools (Claude Code, Cursor, GitHub Copilot) and sets up:
@@ -72,6 +26,7 @@ The installer detects your AI coding tools (Claude Code, Cursor, GitHub Copilot)
 - Slash commands for easy agent invocation
 
 ### Initialize Your Project
+Open your AI Asisted Tool (Claude Code, Cursor, GitHub Copilot) and run the following commands:
 
 ```bash
 # Start the Master Agent
@@ -126,6 +81,55 @@ Each bolt goes through validated stages:
 
 ---
 
+## What is AI-DLC?
+
+AI-DLC is a reimagined software development methodology where **AI drives the conversation** and humans validate. Unlike traditional Agile where iterations span weeks, AI-DLC operates in **Bolts** - rapid iterations measured in hours or days.
+
+> "Traditional development methods were built for human-driven, long-running processes. AI-DLC reimagines the development lifecycle with AI as a central collaborator, enabling rapid cycles measured in hours or days rather than weeks."
+
+### AI-DLC vs Traditional Methods
+
+| Aspect | Agile/Scrum | AI-DLC |
+|--------|-------------|--------|
+| Iteration duration | Weeks (Sprints) | Hours/days (Bolts) |
+| Who drives | Human-driven, AI assists | AI-driven, human-validated |
+| Design techniques | Out of scope | Integrated (DDD, TDD, BDD) |
+| Task decomposition | Manual | AI-powered |
+| Phases | Repeating sprints | Rapid three-phase cycles (Inception → Construction → Operations) |
+| Rituals | Daily standups, retrospectives | Mob Elaboration, Mob Construction |
+
+---
+
+## How It Works
+
+specsmd provides four specialized agents that guide you through the entire development lifecycle:
+
+```
+                    ┌─────────────────┐
+                    │  Master Agent   │  Orchestrates & navigates
+                    └────────┬────────┘
+                             │
+        ┌────────────────────┼────────────────────┐
+        ▼                    ▼                    ▼
+┌───────────────┐   ┌───────────────┐   ┌───────────────┐
+│   Inception   │ → │ Construction  │ → │  Operations   │
+│     Agent     │   │     Agent     │   │     Agent     │
+└───────────────┘   └───────────────┘   └───────────────┘
+  Capture intent      Execute bolts      Deploy & monitor
+  Define units        Build & test       Verify & scale
+  Plan stories        Validate stages
+```
+
+### The Three Phases
+
+| Phase | Agent | Purpose | Key Outputs |
+|-------|-------|---------|-------------|
+| **Inception** | Inception Agent | Capture intents, elaborate requirements, decompose into units | User stories, NFRs, Unit definitions, Bolt plans |
+| **Construction** | Construction Agent | Execute bolts through domain design → logical design → code → test | Domain models, Technical designs, Code, Tests |
+| **Operations** | Operations Agent | Deploy, verify, and monitor | Deployment units, Monitoring, Runbooks |
+
+---
+
 ## Key Concepts
 
 ### Intent

package/flows/aidlc/agents/construction-agent.md

@@ -62,7 +62,6 @@ Current types:
 - `ddd-construction-bolt` - Domain-Driven Design approach
 
 
-
 ---
 
 ## If Bolt Not Found

package/flows/aidlc/skills/inception/bolt-plan.md

@@ -60,6 +60,7 @@ Review all stories to understand:
 **Read bolt type from unit-brief.md or use default based on unit type.**
 
 1. **Check unit-brief.md frontmatter** for `default_bolt_type`:
+
    ```yaml
    ---
    unit: expense-tracker-ui
@@ -77,6 +78,7 @@ Review all stories to understand:
    `.specsmd/aidlc/templates/construction/bolt-types/{bolt-type}.md`
 
 **Available bolt types**:
+
 - `ddd-construction-bolt` - For domain-heavy backend work (5 stages)
 - `simple-construction-bolt` - For UI, integrations, utilities (3 stages)
 - `spike-bolt` - For research and exploration

package/flows/aidlc/skills/inception/units.md

@@ -53,11 +53,13 @@ Break the Intent into independently deployable Units of Work based on project ty
 **CRITICAL**: Before decomposing, understand what types of units to create.
 
 1. **Read project type** from `memory-bank/project.yaml`:
+
    ```yaml
    project_type: full-stack-web  # or backend-api, frontend-app, cli-tool, library
    ```
 
 2. **Read unit structure** from `catalog.yaml` under `project_types.{project_type}.unit_structure`:
+
    ```yaml
    unit_structure:
      backend:
@@ -217,6 +219,7 @@ Present proposed decomposition with their assigned requirements:
    Note: Story naming uses the story title (e.g., `001-user-signup.md`). No prefix field needed.
 
    **For frontend units**, also include:
+
    ```yaml
    unit_type: frontend
    default_bolt_type: simple-construction-bolt

package/lib/installers/AntigravityInstaller.js

@@ -11,7 +11,7 @@ class AntigravityInstaller extends ToolInstaller {
     }
 
     get commandsDir() {
-        return path.join('.agent', 'agents');
+        return path.join('.agent', 'workflows');
     }
 
     get detectPath() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {