Phasekit

Phasekit is an OpenCode-first planning and execution plugin with a harness-agnostic core. It ingests product intent, turns it into small phases, coordinates focused agent work, and keeps committed .planning state as the source of truth.

Status

This repository is a Bun-powered TypeScript workspace. It is set up for open source collaboration, GitHub Releases, and npm packaging for the public @depkit/phasekit-core, @depkit/phasekit-opencode, and @depkit/phasekit-install packages.

Workspace

• packages/core: harness-agnostic planning, orchestration, verification, and artifact logic published as @depkit/phasekit-core.
• packages/opencode: OpenCode plugin adapter published as @depkit/phasekit-opencode.
• packages/install: installer CLI and helper package published as @depkit/phasekit-install.

Requirements

• Bun 1.3.14
• OpenCode for the plugin and generated /pk-* command flow

Setup

bun install --frozen-lockfile

The repo enforces Bun as its package manager with bunx only-allow bun during install.

Development

bun test
bun run typecheck
bun run lint

Usage

Phasekit is designed to be driven through its OpenCode integration.

1. Initialize planning state with /pk-init.
2. Ingest product input with /pk-ingest <path...>.
3. Inspect progress with /pk-status or /pk-next.
4. Execute one approved phase with /pk-run-phase <phase-id>.
5. Run scoped verification with /pk-verify <scope>.

The native execution surface lives in @depkit/phasekit-opencode; generated markdown commands remain thin wrappers around those tools.

For end users, the intended install path is the published installer package:

npx @depkit/phasekit-install --project

Releases

GitHub release automation is managed with release-please.

• pushes to main or master run CI and release automation
• release tags use the vX.X.X format
• package tags are generated per public npm package
• package tarballs can be validated locally with npm pack ./packages/core, npm pack ./packages/opencode, and npm pack ./packages/install
• local build-only release prep runs with bun run release:build
• local publish rehearsal runs with bun run release:publish:dry-run
• local publish runs with bun run release:publish for @depkit/phasekit-core, @depkit/phasekit-opencode, then @depkit/phasekit-install
• GitHub Actions publishes @depkit/phasekit-core, then @depkit/phasekit-opencode, then @depkit/phasekit-install
• configure npm trusted publishers for all public packages against .github/workflows/release.yaml
• publish jobs use npm publish --provenance --access public
• publish jobs skip package versions that already exist on npm

Contributing

See CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md for contribution and reporting guidance.

License

MIT