jmagly/prose-setup

Prose Setup Skill

You ensure the OpenProse repository is cloned and up-to-date so that all prose-integration skills have access to the latest specifications, examples, and guidance.

Triggers

• "setup prose" / "install prose" / "install openprose"
• "update prose" / "update openprose"
• "clone prose repo"
• "ensure prose is available"
• "prose setup"

Behavior

Step 1: Check Current State

Check if OpenProse is already cloned:

# Check default location
ls /tmp/prose/skills/open-prose/prose.md 2>/dev/null

# Check configured location (from addon config proseRoot)

Step 2: Clone or Update

If not present — clone from GitHub:

git clone https://github.com/openprose/prose.git /tmp/prose

If already present — pull latest:

cd /tmp/prose && git pull origin main

Step 3: Verify Installation

After clone/update, verify key files exist:

| File | Purpose | Required | |------|---------|----------| | skills/open-prose/prose.md | Prose VM specification | Yes | | skills/open-prose/forme.md | Forme Container specification | Yes | | skills/open-prose/guidance/patterns.md | Design patterns | Yes | | skills/open-prose/guidance/antipatterns.md | Antipatterns guide | Yes | | skills/open-prose/guidance/tenets.md | Design tenets | Yes | | skills/open-prose/examples/ | Example programs (50+) | Yes |

Step 4: Report Version

cd /tmp/prose && git log -1 --format="%H %ci %s"

Step 5: Output Summary

## OpenProse Setup Complete

**Location**: /tmp/prose
**Version**: {commit hash} ({date})
**Latest commit**: {subject}

### Verified Files
- [x] prose.md (Prose VM spec)
- [x] forme.md (Forme Container spec)
- [x] guidance/ (patterns, antipatterns, tenets)
- [x] examples/ ({count} examples)

### Available Skills
All prose-integration skills now have access to the latest OpenProse specification:
- `/prose-reader` — parse contracts
- `/prose-run` — execute programs
- `/prose-validate` — validate grammar
- `/forme-manifest` — generate wiring manifests

Custom Install Location

If the user wants Prose installed somewhere other than /tmp/prose, they can configure it:

# In aiwg.yml
addons:
  prose-integration:
    proseRoot: /path/to/prose/skills/open-prose
    proseRepoPath: /path/to/prose

The clone target is proseRepoPath (repo root), and proseRoot is {proseRepoPath}/skills/open-prose.

Auto-Setup

Other prose-integration skills should check for the Prose installation before operating. If not found, suggest running /prose-setup first:

OpenProse not found at /tmp/prose/skills/open-prose/prose.md

Run `/prose-setup` to clone the latest OpenProse repository, or configure
a custom path in aiwg.yml under addons.prose-integration.proseRoot

Model

This skill runs on Haiku — it's just git operations and file checks.

References

• @$AIWG_ROOT/agentic/code/addons/prose-integration/README.md — prose-integration addon overview
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md — Verify installation state before cloning or pulling
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/human-authorization.md — Confirm custom install location with user when non-default path requested
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference for AIWG addon configuration