Aiwg prose-setup

Clone or update the OpenProse repository to ensure AIWG prose tools hook into the latest version of the specification and examples

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/prose-setup" ~/.claude/skills/jmagly-aiwg-prose-setup && rm -rf "$T"

manifest: .agents/skills/prose-setup/SKILL.md

source content

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

{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