@magnusekdahl/parallix 1.0.0

package/templates/mission-scaffold.md

@@ -0,0 +1,39 @@
+# Mission: <Title> ({{slug}})
+
+## Goal
+<Goal>
+
+## Why Now
+<Why Now>
+
+## Refinement Signals
+- Estimated agent % usage limit: 25-50%
+- Confidence: High
+- Selection note: activate as-is
+- Main drivers: <drivers>
+
+## Scope
+- <In scope>
+
+## Out of Scope
+- <Out of scope>
+
+## Success Criteria
+> **Falsifiability rule (ADR 0039 Part 2):** Each criterion must be falsifiable. Forbidden: subjective adjectives ("easy, fast, simple, intuitive, user-friendly, responsive, quick, efficient" without an attached metric) and vague quantifiers ("multiple, several, some, many, few, various"). For refactor / condense / migration missions, the criterion must enumerate the specific elements (rules, files, behaviours) that must survive — generic phrases like "preserve critical content" are not sufficient.
+
+- <Criteria 1>
+
+## Risks and Assumptions
+- <Risks>
+
+## Checkpoints
+- CP 1: <Phase 1>
+
+## Gates
+- [ ] ./scripts/verify-local.sh docs
+
+## Restricted Areas
+- <Restricted>
+
+## Stop Rules
+- <Stop rules>

package/templates/vibe/skills/act-on-review/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: act-on-review
+description: Use when the user explicitly asks to process review feedback for a parallix mission, including `/act-on-review` invocations. This is a thin launcher only; load and follow AGENTS.md, the locked MISSION.md, and docs/agent-prompts/act-on-review.md.
+user-invocable: true
+---
+
+# Act On Review
+
+This skill is a thin entrypoint for the parallix act-on-review workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. the locked `MISSION.md` for the mission you are acting on
+3. `docs/agent-prompts/act-on-review.md`
+
+Read live Forgejo findings first, separate stale comments from current ones, and keep the review-response loop in the PR.

package/templates/vibe/skills/area-review/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: area-review
+description: Use when the user explicitly asks for the parallix per-area review flow, including `/area-review` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/area-review.md.
+user-invocable: true
+---
+
+# Area Review
+
+This skill is a thin entrypoint for the parallix per-area review workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/area-review.md`
+
+Keep this as review-only work. Do not turn it into mission execution or portfolio generation.

package/templates/vibe/skills/draft/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: draft
+description: Use when the user explicitly asks for the parallix mission-draft workflow, including `/draft` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/draft.md.
+user-invocable: true
+---
+
+# Draft
+
+This skill is a thin entrypoint for the parallix draft workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/draft.md`
+
+Keep drafting on the mission branch/worktree and keep workflow authority in the canonical docs.

package/templates/vibe/skills/execute/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: execute
+description: Use when the user explicitly asks to execute a locked parallix mission, including `/execute` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/execute.md.
+user-invocable: true
+---
+
+# Execute
+
+This skill is a thin entrypoint for the parallix execution workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/execute.md`
+
+Use the locked `MISSION.md` as the mission-specific execution contract. Do not let this skill replace or weaken it.

package/templates/vibe/skills/integrate/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: integrate
+description: Use when the user explicitly asks for the parallix integration workflow, including `/integrate` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/integrate.md.
+user-invocable: true
+---
+
+# Integrate
+
+This skill is a thin entrypoint for the parallix integration workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/integrate.md`
+
+Keep integration logic in the canonical prompt and use the documented cleanup and closeout path.

package/templates/vibe/skills/portfolio/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: portfolio
+description: Use when the user explicitly asks for the parallix portfolio workflow, including `/portfolio` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/portfolio.md rather than inventing a parallel workflow.
+user-invocable: true
+---
+
+# Portfolio
+
+This skill is a thin entrypoint for the parallix portfolio workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/portfolio.md`
+
+Authority:
+- `AGENTS.md` owns hard rules and workflow boundaries.
+- `parallix/README.md` owns workflow modes and prompt mapping.
+- `docs/agent-prompts/portfolio.md` owns the portfolio execution prompt.
+
+Do not treat this skill as a second workflow authority. It exists only to shorten invocation in Vibe.

package/templates/vibe/skills/review/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: review
+description: Use when the user explicitly asks for the parallix review workflow, including `/review` invocations. This is a thin launcher only; load and follow AGENTS.md, parallix/README.md, and docs/agent-prompts/review.md.
+user-invocable: true
+---
+
+# Review
+
+This skill is a thin entrypoint for the parallix review workflow.
+
+Load and follow:
+1. `AGENTS.md`
+2. `parallix/README.md`
+3. `docs/agent-prompts/review.md`
+
+Keep review output and review-state transitions aligned with the canonical docs and the Forgejo review surface.

package/tools/setup-forgejo-docker.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+FORGEJO_DIR="${REPO_ROOT}/forgejo"
+COMPOSE_FILE="${FORGEJO_DIR}/docker-compose.yml"
+STATE_DIR="${REPO_ROOT}/.forgejo-local"
+FORCE=0
+START=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --force)
+      FORCE=1
+      shift
+      ;;
+    --start)
+      START=1
+      shift
+      ;;
+    --help|-h)
+      cat <<EOF
+Usage: $0 [--force] [--start]
+
+Creates a minimal Forgejo docker-compose file for the current repo.
+
+Options:
+  --force  Overwrite an existing forgejo/docker-compose.yml
+  --start  Start the Forgejo container after writing the compose file
+EOF
+      exit 0
+      ;;
+    *)
+      echo "[ERROR] Unknown argument: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -f "${COMPOSE_FILE}" && ${FORCE} -ne 1 ]]; then
+  echo "[ERROR] ${COMPOSE_FILE} already exists. Use --force to overwrite." >&2
+  exit 1
+fi
+
+mkdir -p "${FORGEJO_DIR}" "${STATE_DIR}/server"
+
+cat >"${COMPOSE_FILE}" <<'EOF'
+services:
+  forgejo:
+    image: codeberg.org/forgejo/forgejo:12
+    container_name: ${FORGEJO_CONTAINER_NAME:-workflow-forgejo}
+    restart: unless-stopped
+    environment:
+      USER_UID: ${UID:-1000}
+      USER_GID: ${GID:-1000}
+      FORGEJO__server__ROOT_URL: ${FORGEJO_ROOT_URL:-http://localhost:3300/}
+    ports:
+      - "${FORGEJO_PORT:-3300}:3000"
+    volumes:
+      - ../.forgejo-local/server:/data
+EOF
+
+cat <<EOF
+[INFO] Wrote ${COMPOSE_FILE}
+[INFO] Forgejo data will live in ${STATE_DIR}/server
+[INFO] Next steps:
+[INFO]   1. docker compose -f forgejo/docker-compose.yml up -d
+[INFO]   2. Open http://localhost:\${FORGEJO_PORT:-3300}
+[INFO]   3. Read parallix/docs/forgejo-setup.md for token and remote wiring
+[INFO]   4. Run px setup after export to finish config and review wiring
+EOF
+
+if [[ ${START} -eq 1 ]]; then
+  if command -v docker >/dev/null 2>&1; then
+    docker compose -f "${COMPOSE_FILE}" up -d
+  elif command -v docker-compose >/dev/null 2>&1; then
+    docker-compose -f "${COMPOSE_FILE}" up -d
+  else
+    echo "[ERROR] docker or docker-compose is required for --start" >&2
+    exit 1
+  fi
+  echo "[INFO] Forgejo container started."
+fi