Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .agents/skills/quest-afk/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-afk
description: Keep quest work moving while the user is away, leaving every decision for their return.
---

Run `quest skill afk` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill afk` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-audit/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-audit
description: Audit and fix outstanding quests for disagreements, conflicts, misaligned priorities, and stale plans. Use when the user invokes /quest-audit or asks to audit and fix the quest tree.
---

Run `quest skill audit` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill audit` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-complete/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-complete
description: Decide which open PRs to merge, then queue them.
---

Run `quest skill complete` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill complete` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-delete/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-delete
description: Abandon a quest.
---

Run `quest skill delete` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill delete` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-export/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-export
description: Turn active quests into GitHub issues before leaving Quest. Use when the user invokes /quest-export or asks to export quests before removing Quest.
---

Run `quest skill export` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill export` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-grill/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-grill
description: Settle open decisions through an interactive interview with the user. Use when the user invokes /quest-grill or wants unsettled thinking challenged before action.
---

Run `quest skill grill` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill grill` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-import/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-import
description: Import GitHub issues as quests.
---

Run `quest skill import` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill import` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-iterate/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-iterate
description: Iterate on an open PR to settle its open decisions, fix CI and review findings, and push.
---

Run `quest skill iterate` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill iterate` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-merge/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-merge
description: Queue a PR to land, running /quest-iterate first when it needs work.
---

Run `quest skill merge` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill merge` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-plan/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-plan
description: Scope and create quests through an interactive interview. Use when the user invokes /quest-plan, asks to plan a quest, or wants unsettled work split into quests.
---

Run `quest skill plan` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill plan` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-recurring/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-recurring
description: Plan a quest that repeats, such as a periodic audit or a release cut. Use when the user invokes /quest-recurring or wants the same work redone each milestone or release.
---

Run `quest skill recurring` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill recurring` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-review
description: Review a PR's branch locally with the other vendor's model, then mark it ready for review.
---

Run `quest skill review` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill review` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-spawn/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-spawn
description: Start multiple quests in parallel.
---

Run `quest skill spawn` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill spawn` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-start/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-start
description: Start work on a quest.
---

Run `quest skill start` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill start` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .agents/skills/quest-unblock/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-unblock
description: Walk the maintainer through every quest and draft PR waiting on them, and clear waits that have resolved.
---

Run `quest skill unblock` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill unblock` instead; prefix later Quest commands with `nix develop --command` too.
11 changes: 11 additions & 0 deletions .claude/hooks/direnv.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
#!/usr/bin/env bash
set -eu

[ -n "${CLAUDE_ENV_FILE:-}" ] || exit 0
[ -n "${CLAUDE_PROJECT_DIR:-}" ] || exit 0
command -v direnv >/dev/null 2>&1 || exit 0
[ -f "$CLAUDE_PROJECT_DIR/.envrc" ] || exit 0

# Check approval before the shared exporter can call direnv allow.
direnv exec "$CLAUDE_PROJECT_DIR" true
exec "$CLAUDE_PROJECT_DIR/moq/.claude/hooks/direnv.sh"
15 changes: 15 additions & 0 deletions .claude/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "if [ -n \"${CLAUDE_PROJECT_DIR:-}\" ]; then \"${CLAUDE_PROJECT_DIR}/.claude/hooks/direnv.sh\"; fi"
}
]
}
]
}
}
7 changes: 7 additions & 0 deletions .claude/skills/quest-afk/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-afk
description: Keep quest work moving while the user is away, leaving every decision for their return.
---

Run `quest skill afk` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill afk` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-audit/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-audit
description: Audit and fix outstanding quests for disagreements, conflicts, misaligned priorities, and stale plans. Use when the user invokes /quest-audit or asks to audit and fix the quest tree.
---

Run `quest skill audit` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill audit` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-complete/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-complete
description: Decide which open PRs to merge, then queue them.
---

Run `quest skill complete` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill complete` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-delete/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-delete
description: Abandon a quest.
---

Run `quest skill delete` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill delete` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-export/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-export
description: Turn active quests into GitHub issues before leaving Quest. Use when the user invokes /quest-export or asks to export quests before removing Quest.
---

Run `quest skill export` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill export` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-grill/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-grill
description: Settle open decisions through an interactive interview with the user. Use when the user invokes /quest-grill or wants unsettled thinking challenged before action.
---

Run `quest skill grill` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill grill` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-import/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-import
description: Import GitHub issues as quests.
---

Run `quest skill import` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill import` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-iterate/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-iterate
description: Iterate on an open PR to settle its open decisions, fix CI and review findings, and push.
---

Run `quest skill iterate` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill iterate` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-merge/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-merge
description: Queue a PR to land, running /quest-iterate first when it needs work.
---

Run `quest skill merge` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill merge` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-plan/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-plan
description: Scope and create quests through an interactive interview. Use when the user invokes /quest-plan, asks to plan a quest, or wants unsettled work split into quests.
---

Run `quest skill plan` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill plan` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-recurring/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-recurring
description: Plan a quest that repeats, such as a periodic audit or a release cut. Use when the user invokes /quest-recurring or wants the same work redone each milestone or release.
---

Run `quest skill recurring` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill recurring` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-review/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-review
description: Review a PR's branch locally with the other vendor's model, then mark it ready for review.
---

Run `quest skill review` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill review` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-spawn/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-spawn
description: Start multiple quests in parallel.
---

Run `quest skill spawn` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill spawn` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-start/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-start
description: Start work on a quest.
---

Run `quest skill start` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill start` instead; prefix later Quest commands with `nix develop --command` too.
7 changes: 7 additions & 0 deletions .claude/skills/quest-unblock/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
name: quest-unblock
description: Walk the maintainer through every quest and draft PR waiting on them, and clear waits that have resolved.
---

Run `quest skill unblock` and follow its output.
If `quest` is not on `PATH`, run `nix develop --command quest skill unblock` instead; prefix later Quest commands with `nix develop --command` too.
2 changes: 2 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,5 @@
*.icns filter=lfs diff=lfs merge=lfs -text
*.ico filter=lfs diff=lfs merge=lfs -text
*.onnx filter=lfs diff=lfs merge=lfs -text

quest/** merge=quest
18 changes: 13 additions & 5 deletions .github/workflows/check.yml
Original file line number Diff line number Diff line change
@@ -1,26 +1,34 @@
name: Check

permissions:
id-token: write
contents: read

on:
pull_request:
branches: ["main"]
types: [opened, synchronize, reopened, ready_for_review]

jobs:
check:
name: Check
if: ${{ !github.event.pull_request.draft }}
runs-on: ubuntu-latest

steps:
- name: Checkout
uses: actions/checkout@v4
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
submodules: recursive
persist-credentials: false

- uses: DeterminateSystems/nix-installer-action@main
- uses: DeterminateSystems/magic-nix-cache-action@main
- uses: DeterminateSystems/flake-checker-action@main
- uses: DeterminateSystems/nix-installer-action@1d87d45818068401a10cf16bdc5f00b24994a83f # main
with:
determinate: false
extra-conf: |
accept-flake-config = true
- uses: DeterminateSystems/magic-nix-cache-action@f69a2d3e148e90223fe63ab6e3f6331f2e7e33dc # main
with:
use-flakehub: false
use-gha-cache: true
- uses: DeterminateSystems/flake-checker-action@786422608c7bded2bbc9741ad9f91356842bf520 # main
- run: nix develop --command bash -c 'just check && just build'
19 changes: 19 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Hang

Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, checks, and pull requests.
Trust the pinned `moq/` source over published API references.

Quests: before any work, run `quest context` and follow it.
The CLI, guide, and skills come from MoQ's Quest flake input; upgrade them upstream and bump MoQ here.

# Development

- Use Bun workspaces; `@moq/*` comes from the pinned submodule.
- Keep reusable media/protocol changes in MoQ and application behavior here.
- Prefer ESM namespace imports and explicit types; do not use `any` or type escape hatches.
- Use Biome's configured formatting.
- Do not start `just dev` unless requested.

`quest init` may install Claude worktree hooks in the pinned version. Keep the
SessionStart direnv hook in `.claude/settings.json`; worktree creation is managed
by the host.
Loading
Loading