Getting started

This tutorial installs woostack in an existing repository. When you finish, your harness can find the skills and the repository has local woostack support.

Before you start

Prepare:

• An agent harness that supports Agent Skills.
• Node.js and pnpm. The installation command below uses pnpx.
• Bash, Git, the GitHub CLI (gh), the Graphite CLI (gt), and jq. Authenticate both CLIs and initialize Graphite for the repository before using a workflow that delivers a pull request.

You do not need Linear, Plane, or GitHub for this tutorial. Local run artifacts are the default.

1. Install the skills

Run this command from the repository:

pnpx skills add howarewoo/woostack

Confirm that your harness can find using-woostack and the /woostack-* command skills. If the skills do not appear, stop here and fix the harness installation before continuing.

2. Initialize local support

Invoke the initialization skill from the same repository:

/woostack-init

Initialization creates or repairs non-secret repository policy, diagnostic report directories, worktree support, and the host-specific local support that woostack needs. It preserves unrelated project agents and extensions.

When the command finishes, confirm that .woostack/config.json exists. The command may also report read-only Linear discovery (or GitHub discovery when artifacts.provider: "github" is selected), but missing provider access does not block local initialization.

3. Check the installation

Invoke:

/woostack-doctor --check

Doctor checks the local .woostack/ policy and support surfaces without repairing them in --check mode. Resolve any reported local configuration error before starting repository work. Optional provider connectivity matters only when you configure provider mirroring.

Choose what to do next

Use the workflow map to choose a command for real work. Read the configuration reference only when you need to change repository policy or enable optional provider mirroring.