Name: ship
Author: asabocinski

Prompt file imported from asabocinski/bravo-edd (.codex/prompts/ship.md). Copyright stays with the author.

Ship Command

Archive completed feature with lessons learned (Phase 4)

Usage

/ship <define-file>

Examples

/ship .codex/sdd/features/DEFINE_NOTIFICATION_SYSTEM.md
/ship DEFINE_USER_AUTH.md

Overview

This is Phase 4 of the 5-phase AgentSpec workflow:

Phase 0: /brainstorm → .codex/sdd/features/BRAINSTORM_{FEATURE}.md (optional)
Phase 1: /define     → .codex/sdd/features/DEFINE_{FEATURE}.md
Phase 2: /design     → .codex/sdd/features/DESIGN_{FEATURE}.md
Phase 3: /build      → Code + .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md
Phase 4: /ship       → .codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md (THIS COMMAND)

The /ship command archives all feature artifacts and captures lessons learned.

What This Command Does

Verify - Confirm all artifacts exist and build passed
Archive - Move feature documents to archive folder
Document - Create SHIPPED summary with lessons learned
Clean - Remove working files from features folder

Process

Step 1: Verify Completion

Read(.codex/sdd/features/DEFINE_{FEATURE}.md)
Read(.codex/sdd/features/DESIGN_{FEATURE}.md)
Read(.codex/sdd/reports/BUILD_REPORT_{FEATURE}.md)

# Verify build report shows success

Step 2: Create Archive Folder

mkdir -p .codex/sdd/archive/{FEATURE_NAME}/

Step 3: Copy Artifacts to Archive

cp .codex/sdd/features/DEFINE_{FEATURE}.md .codex/sdd/archive/{FEATURE}/
cp .codex/sdd/features/DESIGN_{FEATURE}.md .codex/sdd/archive/{FEATURE}/
cp .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md .codex/sdd/archive/{FEATURE}/

Step 4: Generate SHIPPED Document

Create summary with:

Section	Content
Summary	What was built
Timeline	Start → Ship dates
Metrics	Lines of code, files created
Lessons Learned	What went well, what to improve
Artifacts	List of all archived documents

Step 5: Update Document Statuses

Update archived documents to "Shipped" status:

Edit: archive/{FEATURE}/DEFINE_{FEATURE}.md
  - Status: → "✅ Shipped"
  - Add revision: "Shipped and archived"

Edit: archive/{FEATURE}/DESIGN_{FEATURE}.md
  - Status: → "✅ Shipped"
  - Add revision: "Shipped and archived"

Step 6: Clean Up Working Files

rm .codex/sdd/features/DEFINE_{FEATURE}.md
rm .codex/sdd/features/DESIGN_{FEATURE}.md
rm .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md

Step 7: Save SHIPPED Document

Write(.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md)

Output

Artifact	Location
SHIPPED	`.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md`
DEFINE	`.codex/sdd/archive/{FEATURE}/DEFINE_{FEATURE}.md`
DESIGN	`.codex/sdd/archive/{FEATURE}/DESIGN_{FEATURE}.md`
BUILD_REPORT	`.codex/sdd/archive/{FEATURE}/BUILD_REPORT_{FEATURE}.md`

Next Step: Start new feature with /define

Quality Gate

Before shipping, verify:

[ ] BUILD_REPORT shows all tasks completed
[ ] No critical issues in build report
[ ] All tests passing
[ ] Code deployed (if applicable)

When to Ship

Ship when:

All acceptance tests from DEFINE pass
Build report shows 100% completion
No blocking issues remain

Lessons Learned Categories

Document lessons in these areas:

Category	Example
Process	"Breaking tasks into smaller chunks helped"
Technical	"Config files work better than env vars"
Communication	"Early clarification saved rework"
Tools	"Using X library simplified Y"

Tips

Don't Skip This - Lessons learned prevent future mistakes
Be Honest - Document what didn't work too
Be Specific - "Better planning" → "Create architecture diagram before coding"
Archive Everything - Future you will thank present you

References

Agent: .codex/skills/ship-agent.md
Template: .codex/sdd/templates/SHIPPED_TEMPLATE.md
Contracts: .codex/sdd/architecture/WORKFLOW_CONTRACTS.yaml
Previous Phase: .codex/prompts/build.md

Install ship and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Ship Command > Archive completed feature with lessons learned (Phase 4) ## Usage ```bash /ship <define-file> ``` ## Examples ```bash /ship .codex/sdd/features/DEFINE_NOTIFICATION_SYSTEM.md /ship DEFINE_USER_AUTH.md ``` --- ## Overview This is **Phase 4** of the 5-phase AgentSpec workflow: ```text Phase 0: /brainstorm → .codex/sdd/features/BRAINSTORM_{FEATURE}.md (optional) Phase 1: /define → .codex/sdd/features/DEFINE_{FEATURE}.md Phase 2: /design → .codex/sdd/features/DESIGN_{FEATURE}.md Phase 3: /build → Code + .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md Phase 4: /ship → .codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md (THIS COMMAND) ``` The `/ship` command archives all feature artifacts and captures lessons learned. --- ## What This Command Does 1. **Verify** - Confirm all artifacts exist and build passed 2. **Archive** - Move feature documents to archive folder 3. **Document** - Create SHIPPED summary with lessons learned 4. **Clean** - Remove working files from features folder --- ## Process ### Step 1: Verify Completion ```markdown Read(.codex/sdd/features/DEFINE_{FEATURE}.md) Read(.codex/sdd/features/DESIGN_{FEATURE}.md) Read(.codex/sdd/reports/BUILD_REPORT_{FEATURE}.md) # Verify build report shows success ``` ### Step 2: Create Archive Folder ```bash mkdir -p .codex/sdd/archive/{FEATURE_NAME}/ ``` ### Step 3: Copy Artifacts to Archive ```bash cp .codex/sdd/features/DEFINE_{FEATURE}.md .codex/sdd/archive/{FEATURE}/ cp .codex/sdd/features/DESIGN_{FEATURE}.md .codex/sdd/archive/{FEATURE}/ cp .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md .codex/sdd/archive/{FEATURE}/ ``` ### Step 4: Generate SHIPPED Document Create summary with: | Section | Content | |---------|---------| | **Summary** | What was built | | **Timeline** | Start → Ship dates | | **Metrics** | Lines of code, files created | | **Lessons Learned** | What went well, what to improve | | **Artifacts** | List of all archived documents | ### Step 5: Update Document Statuses Update archived documents to "Shipped" status: ```markdown Edit: archive/{FEATURE}/DEFINE_{FEATURE}.md - Status: → "✅ Shipped" - Add revision: "Shipped and archived" Edit: archive/{FEATURE}/DESIGN_{FEATURE}.md - Status: → "✅ Shipped" - Add revision: "Shipped and archived" ``` ### Step 6: Clean Up Working Files ```bash rm .codex/sdd/features/DEFINE_{FEATURE}.md rm .codex/sdd/features/DESIGN_{FEATURE}.md rm .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md ``` ### Step 7: Save SHIPPED Document ```markdown Write(.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md) ``` --- ## Output | Artifact | Location | |----------|----------| | **SHIPPED** | `.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md` | | **DEFINE** | `.codex/sdd/archive/{FEATURE}/DEFINE_{FEATURE}.md` | | **DESIGN** | `.codex/sdd/archive/{FEATURE}/DESIGN_{FEATURE}.md` | | **BUILD_REPORT** | `.codex/sdd/archive/{FEATURE}/BUILD_REPORT_{FEATURE}.md` | **Next Step:** Start new feature with `/define` --- ## Quality Gate Before shipping, verify: ```text [ ] BUILD_REPORT shows all tasks completed [ ] No critical issues in build report [ ] All tests passing [ ] Code deployed (if applicable) ``` --- ## When to Ship Ship when: - All acceptance tests from DEFINE pass - Build report shows 100% completion - No blocking issues remain --- ## Lessons Learned Categories Document lessons in these areas: | Category | Example | |----------|---------| | **Process** | "Breaking tasks into smaller chunks helped" | | **Technical** | "Config files work better than env vars" | | **Communication** | "Early clarification saved rework" | | **Tools** | "Using X library simplified Y" | --- ## Tips 1. **Don't Skip This** - Lessons learned prevent future mistakes 2. **Be Honest** - Document what didn't work too 3. **Be Specific** - "Better planning" → "Create architecture diagram before coding" 4. **Archive Everything** - Future you will thank present you --- ## References - Agent: `.codex/skills/ship-agent.md` - Template: `.codex/sdd/templates/SHIPPED_TEMPLATE.md` - Contracts: `.codex/sdd/architecture/WORKFLOW_CONTRACTS.yaml` - Previous Phase: `.codex/prompts/build.md`

{ "prompt": "# Ship Command\n\n> Archive completed feature with lessons learned (Phase 4)\n\n## Usage\n\n```bash\n/ship <define-file>\n```\n\n## Examples\n\n```bash\n/ship .codex/sdd/features/DEFINE_NOTIFICATION_SYSTEM.md\n/ship DEFINE_USER_AUTH.md\n```\n\n---\n\n## Overview\n\nThis is **Phase 4** of the 5-phase AgentSpec workflow:\n\n```text\nPhase 0: /brainstorm → .codex/sdd/features/BRAINSTORM_{FEATURE}.md (optional)\nPhase 1: /define → .codex/sdd/features/DEFINE_{FEATURE}.md\nPhase 2: /design → .codex/sdd/features/DESIGN_{FEATURE}.md\nPhase 3: /build → Code + .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md\nPhase 4: /ship → .codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md (THIS COMMAND)\n```\n\nThe `/ship` command archives all feature artifacts and captures lessons learned.\n\n---\n\n## What This Command Does\n\n1. **Verify** - Confirm all artifacts exist and build passed\n2. **Archive** - Move feature documents to archive folder\n3. **Document** - Create SHIPPED summary with lessons learned\n4. **Clean** - Remove working files from features folder\n\n---\n\n## Process\n\n### Step 1: Verify Completion\n\n```markdown\nRead(.codex/sdd/features/DEFINE_{FEATURE}.md)\nRead(.codex/sdd/features/DESIGN_{FEATURE}.md)\nRead(.codex/sdd/reports/BUILD_REPORT_{FEATURE}.md)\n\n# Verify build report shows success\n```\n\n### Step 2: Create Archive Folder\n\n```bash\nmkdir -p .codex/sdd/archive/{FEATURE_NAME}/\n```\n\n### Step 3: Copy Artifacts to Archive\n\n```bash\ncp .codex/sdd/features/DEFINE_{FEATURE}.md .codex/sdd/archive/{FEATURE}/\ncp .codex/sdd/features/DESIGN_{FEATURE}.md .codex/sdd/archive/{FEATURE}/\ncp .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md .codex/sdd/archive/{FEATURE}/\n```\n\n### Step 4: Generate SHIPPED Document\n\nCreate summary with:\n\n| Section | Content |\n|---------|---------|\n| **Summary** | What was built |\n| **Timeline** | Start → Ship dates |\n| **Metrics** | Lines of code, files created |\n| **Lessons Learned** | What went well, what to improve |\n| **Artifacts** | List of all archived documents |\n\n### Step 5: Update Document Statuses\n\nUpdate archived documents to \"Shipped\" status:\n\n```markdown\nEdit: archive/{FEATURE}/DEFINE_{FEATURE}.md\n - Status: → \"✅ Shipped\"\n - Add revision: \"Shipped and archived\"\n\nEdit: archive/{FEATURE}/DESIGN_{FEATURE}.md\n - Status: → \"✅ Shipped\"\n - Add revision: \"Shipped and archived\"\n```\n\n### Step 6: Clean Up Working Files\n\n```bash\nrm .codex/sdd/features/DEFINE_{FEATURE}.md\nrm .codex/sdd/features/DESIGN_{FEATURE}.md\nrm .codex/sdd/reports/BUILD_REPORT_{FEATURE}.md\n```\n\n### Step 7: Save SHIPPED Document\n\n```markdown\nWrite(.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md)\n```\n\n---\n\n## Output\n\n| Artifact | Location |\n|----------|----------|\n| **SHIPPED** | `.codex/sdd/archive/{FEATURE}/SHIPPED_{DATE}.md` |\n| **DEFINE** | `.codex/sdd/archive/{FEATURE}/DEFINE_{FEATURE}.md` |\n| **DESIGN** | `.codex/sdd/archive/{FEATURE}/DESIGN_{FEATURE}.md` |\n| **BUILD_REPORT** | `.codex/sdd/archive/{FEATURE}/BUILD_REPORT_{FEATURE}.md` |\n\n**Next Step:** Start new feature with `/define`\n\n---\n\n## Quality Gate\n\nBefore shipping, verify:\n\n```text\n[ ] BUILD_REPORT shows all tasks completed\n[ ] No critical issues in build report\n[ ] All tests passing\n[ ] Code deployed (if applicable)\n```\n\n---\n\n## When to Ship\n\nShip when:\n- All acceptance tests from DEFINE pass\n- Build report shows 100% completion\n- No blocking issues remain\n\n---\n\n## Lessons Learned Categories\n\nDocument lessons in these areas:\n\n| Category | Example |\n|----------|---------|\n| **Process** | \"Breaking tasks into smaller chunks helped\" |\n| **Technical** | \"Config files work better than env vars\" |\n| **Communication** | \"Early clarification saved rework\" |\n| **Tools** | \"Using X library simplified Y\" |\n\n---\n\n## Tips\n\n1. **Don't Skip This** - Lessons learned prevent future mistakes\n2. **Be Honest** - Document what didn't work too\n3. **Be Specific** - \"Better planning\" → \"Create architecture diagram before coding\"\n4. **Archive Everything** - Future you will thank present you\n\n---\n\n## References\n\n- Agent: `.codex/skills/ship-agent.md`\n- Template: `.codex/sdd/templates/SHIPPED_TEMPLATE.md`\n- Contracts: `.codex/sdd/architecture/WORKFLOW_CONTRACTS.yaml`\n- Previous Phase: `.codex/prompts/build.md`", "variables": [], "notes": "Archive completed feature with lessons learned (Phase 4)", "metadata": { "source": { "provider": "github-codex-prompts", "repository": "https://github.com/asabocinski/bravo-edd", "path": ".codex/prompts/ship.md", "ref": "ae4c539580470e782ac67d2dc4a4eabe9fc68336", "url": "https://github.com/asabocinski/bravo-edd/blob/ae4c539580470e782ac67d2dc4a4eabe9fc68336/.codex/prompts/ship.md", "key": "asabocinski/bravo-edd/.codex/prompts/ship.md" } } }

ship

About