Skip to content

Commit 9c150b6

Browse files
roodboiclaude
andcommitted
chore: refresh agent docs and de-register tickets for this repo
AGENTS.md/CLAUDE.md marker blocks re-synced from the instruction source (worktrees + running-things guides, no tickets). Tickets extension disabled in project config; tickets doc blocks and project codex skill removed. Default-scope phase-out of the tickets integration lands separately. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 346b2c8 commit 9c150b6

4 files changed

Lines changed: 70 additions & 174 deletions

File tree

.codex/skills/hack-tickets/SKILL.md

Lines changed: 0 additions & 67 deletions
This file was deleted.

.hack/hack.config.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"enabled": true
99
},
1010
"dance.hack.tickets": {
11-
"enabled": true
11+
"enabled": false
1212
},
1313
"dance.hack.linear": {
1414
"enabled": true

AGENTS.md

Lines changed: 29 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -66,33 +66,6 @@ Never use any types and always default to leveraging generics and smart types to
6666
- Before adding new branch-heavy logic there, prefer extracting a small helper with a narrow contract and direct tests.
6767
- Do not grow top-level command handlers when the real change is a decision table, state transition, or reusable readiness check.
6868

69-
<!-- hack:tickets:start -->
70-
## Tickets (git-backed)
71-
72-
This project uses `hack` tickets (extension: `dance.hack.tickets`).
73-
74-
Common commands:
75-
- Create: `hack tickets create --title "..." --body-stdin [--depends-on "T-00001"] [--blocks "T-00002"]`
76-
- List: `hack tickets list`
77-
- Tui: `hack tickets tui`
78-
- Show: `hack tickets show T-00001`
79-
- Update: `hack tickets update T-00001 [--title "..."] [--body "..."] [--depends-on "..."] [--blocks "..."]`
80-
- Status: `hack tickets status T-00001 in_progress`
81-
- Sync: `hack tickets sync`
82-
83-
Recommended body template (Markdown):
84-
```md
85-
## Context
86-
## Goals
87-
## Notes
88-
## Links
89-
```
90-
91-
Tip: use `--body-stdin` for multi-line markdown.
92-
93-
Data lives in `.hack/tickets/` (gitignored on the main branch) and syncs to hidden ref `refs/hack/tickets` by default.
94-
<!-- hack:tickets:end -->
95-
9669
## Landing the Plane (Session Completion)
9770
**When ending a work session**, you MUST complete ALL steps below.
9871

@@ -230,17 +203,19 @@ Most formatting and common issues are automatically fixed by Biome. Run `bun x u
230203
<!-- hack:agent-docs:start -->
231204
## hack CLI (local dev + MCP)
232205

233-
Use `hack` as the single interface for local-first runtime orchestration (compose, DNS/TLS, logs, env, persistent project workspaces, and optional local tickets).
206+
Use `hack` as the single interface for local-first runtime orchestration (compose, DNS/TLS, logs, env, and persistent project workspaces).
234207

235208
Product boundary:
236-
- Supported v3 surface: project init, up/down/restart, open, logs, env, host exec/shell, sessions, doctor, daemon, and optional local tickets.
209+
- Supported v3 surface: project init, up/down/restart, open, logs, env, host exec/shell, sessions, doctor, and daemon.
237210
- Removed surfaces: hosted auth/account/org/team flows, web dashboard, built-in GitHub workflows, and built-in Linear sync.
238-
- Unsupported experimental: remote/gateway/node/dispatch. Do not use these as the default path unless explicitly requested.
211+
- Experimental and unsupported: remote/gateway/node/dispatch commands. They are hidden from default help (list with `hack help --all`) and warn on use; do not use them unless explicitly requested.
239212

240213
Operating rules:
241214
- Prefer `hack` over raw `docker` / `docker compose` for project workflows.
242215
- Do not start/stop services from Docker Desktop UI for `hack`-managed projects.
243216
- Treat `.hack/.internal` and `.hack/.branch` as hack-managed artifacts; do not hand-edit generated files there.
217+
- Use `--json` for machine-readable output when available; `hack up/down/restart/doctor --json` emit an `{ok, data | error: {code, message}}` envelope with stable E_* error codes.
218+
- Scripted/agent runs: pass `--no-interactive` (or set `HACK_NO_INTERACTIVE=1`) so commands never block on prompts — they apply documented defaults or fail fast with E_INTERACTIVE_REQUIRED.
244219
- Use MCP only when shell access is unavailable.
245220
- If runtime state looks wrong, run `hack doctor`, then `hack doctor --fix` before manual repair.
246221

@@ -273,11 +248,15 @@ Project files (managed vs generated):
273248
- Source-of-truth files: `.hack/docker-compose.yml`, `.hack/hack.config.json`, `.hack/hack.env.default.yaml`, and optional `.hack/hack.env.<overlay>.yaml`.
274249
- Worktree-local env override files: `.hack/hack.env.local.yaml` and `.hack/hack.env.<overlay>.local.yaml`.
275250
- Local-only files: `.hack.secret.key`, optional `.hack/.env` compatibility output, `.hack/.env.state.json`, and `.hack/.internal/` (runtime/local machine state; keep gitignored).
276-
- Linked worktrees can inherit secret decryption through the git common dir; use `HACK_ENV_SECRET_KEY` in CI/managed containers.
277251
- Generated (do not hand-edit): `.hack/.internal/compose.override.yml`, `.hack/.internal/compose.env.override.yml`, `.hack/.branch/compose.<branch>.override.yml`.
278252
- Managed via CLI: `.hack/.internal/extra-hosts.json` (use `hack internal extra-hosts ...` commands).
279253
- Lifecycle runtime files: `.hack/.internal/lifecycle/state.json`, `.hack/.internal/lifecycle/*.log`.
280254

255+
Linked git worktrees:
256+
- Secret key inherits from the primary checkout automatically through the shared git common dir; set `HACK_ENV_SECRET_KEY` for CI or detached environments.
257+
- `hack up` in a linked worktree defaults to a branch instance named after the worktree's git branch; opt out with config `worktree.auto_branch=false` or an explicit `--branch`.
258+
- `hack doctor` flags divergent secret keys and dev_host collisions across checkouts.
259+
281260
Advanced networking (extra_hosts + local proxies/tunnels):
282261
- Static host mappings: set `internal.extra_hosts` in `.hack/hack.config.json`.
283262
- Dynamic host mappings: `hack internal extra-hosts set <hostname> <target>` / `unset` / `list`.
@@ -292,6 +271,13 @@ Standard workflow:
292271
- Restart: `hack restart`
293272
- Stop services: `hack down`
294273

274+
Running things (decision guide):
275+
- One-off command in a fresh service container (deps started as needed): `hack run <service> <cmd...>`.
276+
- Command inside an already-running service container: `hack exec <service> -- <cmd...>`.
277+
- Host script that needs hack-stored env: `hack host exec --env <overlay> --scope <service> -- <cmd...>` — this is THE way to run repo scripts; never read .env files directly.
278+
- Interactive host shell with injected env: `hack host shell --env <overlay> --scope <service>`.
279+
- Call a service over HTTP (from the host or between containers): use its Caddy hostname `https://<sub>.<dev_host>`; discover routable URLs with `hack open --json`.
280+
295281
Logs (default is compose):
296282
- Fast tail: `hack logs --pretty`
297283
- Per-service tail: `hack logs <service>`
@@ -323,28 +309,10 @@ Host-side env helpers:
323309
- Interactive host shell with injected env: `hack host shell --env qa --scope api`
324310
- Run inside an already-running service container: `hack exec api -- bun test`
325311

326-
Tickets (git-backed):
327-
- Create: `hack tickets create --title "..." --body-stdin`
328-
- List/show: `hack tickets list`, `hack tickets show T-AB12CD34EF`
329-
- Status/sync: `hack tickets status T-AB12CD34EF in_progress`, `hack tickets sync`
330-
331-
Global infra:
332-
- Bootstrap once: `hack global install`
333-
- Start/stop/status: `hack global up`, `hack global down`, `hack global status`
334-
- Use `hack global up` before Loki/Grafana queries if global logging is offline.
335-
336-
Unsupported experimental remote nodes + dispatch:
337-
- These commands are source-available but outside the supported v3 product contract.
338-
- Pair/register nodes: `hack node pair ...`, then verify with `hack node list` and `hack node status --watch`.
339-
- Repair SSH for remote Git/mutagen: `hack node ssh setup --node <id>`.
340-
- On node host, inspect workspace map via `hack node workspace list|resolve|attach|remove`.
341-
- Inspect/repair controller-side route bridge with `hack node routes status` and `hack node routes repair`.
342-
- Dispatch remote commands: `hack dispatch run --project <name|id> --node default --branch <branch> --runner generic -- "<command>"`.
343-
344-
When to use a branch instance:
345-
- You need two versions running at once (PR review, experiments, migrations).
346-
- You want to keep a stable environment while testing another branch.
347-
- Use `--branch <name>` on `hack up/open/logs/down` to target it.
312+
Branch instances (parallel envs):
313+
- Use a branch instance when you need two versions running at once (PR review, experiments, migrations) or want to keep a stable environment while testing another branch.
314+
- Target one with `--branch <name>` on up/open/logs/down (for example: `hack up --branch <name> --detach`).
315+
- Linked worktrees pick a branch instance automatically (see Linked git worktrees).
348316

349317
Run commands inside services:
350318
- One-off: `hack run <service> <cmd...>` (uses `docker compose run --rm`)
@@ -357,6 +325,11 @@ Project targeting:
357325
- Else use `--project <name>` (registry) or `--path <repo-root>`.
358326
- List projects: `hack projects --json`
359327

328+
Global infra:
329+
- Bootstrap once: `hack global install`
330+
- Start/stop/status: `hack global up`, `hack global down`, `hack global status`
331+
- Use `hack global up` before Loki/Grafana queries if global logging is offline.
332+
360333
Daemon (optional):
361334
- Start for faster JSON status/ps: `hack daemon start`
362335
- Check status: `hack daemon status`
@@ -377,12 +350,14 @@ Agent setup (CLI-first):
377350
- Cursor rules: `hack setup cursor`
378351
- Claude hooks: `hack setup claude`
379352
- Codex skill: `hack setup codex`
380-
- Tickets skill: `hack setup tickets`
381353
- Refresh all local agent integrations: `hack setup sync --all-scopes`
382354
- Init prompt: `hack agent init` (use --client cursor|claude|codex to open)
383355
- Init patterns: `hack agent patterns`
384356
- MCP (no-shell only): `hack setup mcp`
385357
- MCP install (explicit): `hack mcp install --all --scope project`
358+
359+
Optional extensions:
360+
- A local git-backed tickets extension exists (`hack tickets`) — only use it when the project explicitly uses it.
386361
<!-- hack:agent-docs:end -->
387362

388363
## Learned Workspace Facts

0 commit comments

Comments
 (0)