Process Kit

A repo to standardize a lightweight, generic workflow with two modes:

• Deliver: defined outcome, minimal branching
• Explore: time-boxed investigation that ends with a decision

It supports:

• GitHub Issues (works everywhere, including orgs without Projects)
• GitHub Projects (v2) (optional automation for repos/orgs that use Projects)
• Labels-first workflow (no dependency on naming conventions)
• Auto-linking to branches + PRs (via GitHub CLI helpers + PR template)

Quick start

1. Create a new repo from this template and clone it.

2. In the new repo, run:

./scripts/setup-labels.sh

3. Create work using the Issue templates:

• New issue → Deliver
• New issue → Explore

4. Optional: enable Projects automation

• Create a GitHub Project (v2)
• Create a token and set repo variables/secrets described in docs/projects.md
• Enable the workflow: .github/workflows/add-to-project.yml

Auto-linking (branches + PRs)

Use the helper to create a branch from an issue:

./scripts/branch-from-issue.sh 123 deliver
# or
./scripts/branch-from-issue.sh 456 explore

Open a PR that auto-links back to the issue:

./scripts/pr-from-issue.sh 123

Also see docs/autolinking.md.

Notes

• This repo includes .vscode/ defaults for fast capture (Parking Lot), consistent formatting, and lightweight task/snippet helpers.
• Everything is generic—no references to any specific domain.