Skip to content

desk: always-on primer at ~/.cstack/src/AGENTS.md #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
chasehuh wants to merge 1 commit into
base: main
Choose a base branch
from
Open

desk: always-on primer at ~/.cstack/src/AGENTS.md #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 4 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,10 @@ git clone git@github.com:chasehuh/cstack.git ~/.cstack/src
~/.cstack/src/install.sh --sume-com ~/sume/sume-com
```

Cursor user-global always-apply primer: `~/.cursor/rules/cstack-desk.mdc`
(points at this file). Codex / Claude Code / Grok Build get the same
order via `~/.codex/AGENTS.md`, `~/.claude/CLAUDE.md`, `~/.grok/AGENTS.md`.

Then **read**, in this order:

1. `~/.agents/skills/sume-main-agent-orchestration/SKILL.md` (policy SoT)
Expand Down
1 change: 1 addition & 0 deletions docs/FLOW.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ duplicate the full SKILL into the `.mdc`.

| File | Role |
|---|---|
| `cstack-desk.mdc` | Pointer at `~/.cstack/src/AGENTS.md` (desk primer every agent reads first) |
| `main-agent-orchestration.mdc` | Pointer at orchestration SKILL |
| `sume-chase-work-loop.mdc` | Discuss → issue → Opus enqueue → Grok land |
| `opus-background-terminal.mdc` | `claude-human-stream` recipe: prompt file, `cd` not `--cwd`, `block_until_ms: 0`, title = Job |
Expand Down
3 changes: 2 additions & 1 deletion sume-desk/codex-agents-snippet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
## Sume Orchestration

When this harness is the Sume **main agent**, read and follow:
When this harness is the Sume **main agent**, read and follow, in order:

`~/.cstack/src/AGENTS.md`
`~/.agents/skills/sume-main-agent-orchestration/SKILL.md`

Ignore sections marked **Cursor-only** unless you are Cursor. Before any
Expand Down
27 changes: 27 additions & 0 deletions sume-desk/cursor-rules/user/cstack-desk.mdc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
description: CStack desk primer — first file every agent on this machine reads
alwaysApply: true
---

# CStack desk (pointer)

This machine’s installable SoT is **`chasehuh/cstack`**.

Read this file first, then stop forking it into chat memory:

`~/.cstack/src/AGENTS.md`

Then the policy skill:

`~/.agents/skills/sume-main-agent-orchestration/SKILL.md`

Map of files → when: `~/.cstack/src/docs/FLOW.md`

Refresh after `git pull` in `~/.cstack/src`:

```bash
~/.cstack/src/install.sh --sume-com /Users/chasehuh/sumelabs/sume
```

Do not edit `~/.agents/skills/*` copies. Those are symlinks into
`~/.cstack/src/sume-desk/skills/`.
4 changes: 3 additions & 1 deletion sume-desk/grok-agents-snippet.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
## Sume Orchestration

When this harness is the Sume **main agent** or a Grok Build worker, read:
When this harness is the Sume **main agent** or a Grok Build worker, read
in order:

`~/.cstack/src/AGENTS.md`
`~/.agents/skills/sume-main-agent-orchestration/SKILL.md`

Before any `gt submit` / `gt merge` on `sume-com`, read
Expand Down
13 changes: 12 additions & 1 deletion sume-desk/skills/sume-main-agent-orchestration/check-wiring.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,8 +139,19 @@ check_pointer "$HOME/.cursor/rules/main-agent-orchestration.mdc"

while IFS= read -r rule; do
check_pointer "$rule"
done < <(find "$HOME/sume" "$HOME/chase" "$HOME/dooi" -maxdepth 4 \
done < <(find "$HOME/sume" "$HOME/sumelabs" "$HOME/chase" "$HOME/dooi" -maxdepth 4 \
-path "*/.cursor/rules/main-agent-orchestration.mdc" \
-not -path "*/node_modules/*" -not -path "*worktree*" -not -path "*PURGE*" 2>/dev/null)

if [ -f "$HOME/.cursor/rules/cstack-desk.mdc" ]; then
if grep -q "$HOME/.cstack/src/AGENTS.md" "$HOME/.cursor/rules/cstack-desk.mdc" \
|| grep -q '~/.cstack/src/AGENTS.md' "$HOME/.cursor/rules/cstack-desk.mdc"; then
ok "cursor desk primer points at ~/.cstack/src/AGENTS.md"
else
bad "cursor desk primer missing AGENTS.md pointer: ~/.cursor/rules/cstack-desk.mdc"
fi
else
bad "cursor desk primer missing: ~/.cursor/rules/cstack-desk.mdc"
fi

exit $fail