القائمة
Run just recipes for project tasks. This skill should be used when starting dev servers, running tests, managing BikeRack GUI, generating portraits, or writing new justfile recipes.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Interactive playtest — full-stack (UI + Playwright + UX Designer) or headless (API-only + Python driver). Coordinates cross-workspace bug reporting via ping-pong file with FIXER.
LLM cost and cache forensics — reconcile server-log narrator costs against the Anthropic Admin API, attribute per-model spend, detect dead caching and invisible callers. Use when analyzing API costs, auditing cache efficiency, or when the Console bill doesn't match expectations.
Create epic or story context documents. Reads sprint YAML for epic/story data, reads context-schema.yaml for required sections, populates templates, and writes output to sprint/context/. Epic context is a single-agent operation (no tandem). Story context uses PM + tandem partner for domain-specific observations.
Jira CLI commands for sprint management. Use when viewing, assigning, or updating Jira issues from the command line.
Sprint status, backlog, and story management for Pennyfarthing. Use when checking current sprint status, finding available stories, reviewing backlog, or understanding story context and history. IMPORTANT: Always use `pf sprint` CLI commands - never manually edit sprint YAML.
List available workflows, show current workflow details, and switch workflows mid-session. Use when checking available workflow types (TDD, trivial, agent-docs), viewing current workflow phase, switching to a different workflow pattern, or managing BikeLane stepped workflows.
| name | just |
| description | Run just recipes for project tasks. This skill should be used when starting dev servers, running tests, managing BikeRack GUI, generating portraits, or writing new justfile recipes. |
| args | [recipe] [args...] |
just is a command runner for project tasks. All commands run from the project root.
/pf-just or /pf-just --listList all available recipes.
Run:
just --list
Output: Recipe names with descriptions.
/pf-just buildBuild all packages in the monorepo.
Run:
just build
What it does: Runs pnpm run build to compile TypeScript across all packages.
/pf-just testRun tests for all packages.
Run:
just test
What it does: Runs pnpm test which executes Node.js native test runner across the monorepo.
/pf-just test-guiRun tests for the GUI package only.
Run:
just test-gui
What it does: Runs npm test in packages/cyclist/.
/pf-just test-gui-watchRun GUI tests in watch mode for TDD workflow.
Run:
just test-gui-watch
What it does: Runs Vitest in watch mode, re-running tests on file changes.
/pf-just installInstall dependencies for all packages.
Run:
just install
What it does: Runs pnpm install to install dependencies across the monorepo.
The gui recipe is the main entry point for BikeRack GUI operations.
/pf-just gui (default)Launch BikeRack GUI in web dev mode with hot reload.
Run:
just gui
What it does: Starts the web server with Vite for browser-based development.
/pf-just gui hereLaunch BikeRack GUI for the current directory.
Run:
just gui here
What it does: Starts the web server with pwd as the project directory.
/pf-just gui serverStart BikeRack GUI web server only (no browser).
Run:
just gui server
What it does: Starts the backend server for headless or remote access.
/pf-just gui verboseEnable debug logging for troubleshooting.
Run:
just gui verbose
Combine flags:
just gui here verbose
/pf-just gui dir=<path>Launch BikeRack GUI for a specific project directory.
Run:
just gui dir=/path/to/project
Arguments:
| Arg | Required | Description |
|---|---|---|
dir= | Yes | Absolute path to project directory |
/pf-just gui setupFirst-time setup for BikeRack GUI development.
Run:
just gui setup
What it does:
rm -rf packages/cyclist/dist/)pnpm install)pnpm run build)/pf-just gui doctorDiagnose BikeRack GUI setup issues.
Run:
just gui doctor
just gui doctor --fix
Arguments:
| Arg | Required | Description |
|---|---|---|
--fix | No | Auto-repair detected issues |
What it does: Checks for common setup problems and optionally fixes them.
/pf-just gui buildBuild BikeRack GUI TypeScript only.
Run:
just gui build
What it does: Compiles TypeScript in packages/cyclist/. Builds workspace dependencies first if missing.
/pf-just gui cleanRemove BikeRack GUI build artifacts.
Run:
just gui clean
What it does: Removes packages/cyclist/dist/ directory.
Generate AI portraits for persona themes.
/pf-just portraits <theme>Generate portraits for a specific theme.
Run:
just portraits arthurian-mythos
Arguments:
| Arg | Required | Description |
|---|---|---|
theme | Yes | Theme name (e.g., arthurian-mythos, the-expanse) |
/pf-just portraits-allGenerate portraits for all themes.
Run:
just portraits-all
Warning: This is time-intensive. Generates portraits for all 102 themes.
/pf-just portraits-preview <theme>Preview portraits for a theme without saving.
Run:
just portraits-preview arthurian-mythos
Arguments:
| Arg | Required | Description |
|---|---|---|
theme | Yes | Theme name to preview |
Just recipes accept arguments directly (no -- separator needed):
# Correct
just test-gui --filter "B-001"
just gui here verbose
# WRONG - don't use --
just test-gui -- --filter "B-001"
Run:
just --show <recipe>
Example:
just --show gui
# Shows the full recipe implementation
| Command | Description |
|---|---|
just | List available recipes |
just build | Build all packages |
just test | Run all tests |
just test-gui | Run GUI tests |
just test-gui-watch | GUI tests in watch mode |
just install | Install dependencies |
just gui | Web dev mode (default) |
just gui here | Web dev + current directory |
just gui server | Web server only |
just gui setup | First-time setup |
just gui doctor | Diagnose issues |
just gui build | Build TypeScript |
just gui clean | Remove dist/ |
just portraits <theme> | Generate theme portraits |
just portraits-all | Generate all portraits |
just portraits-preview <theme> | Preview portraits |
brew install just
# or
cargo install just