style(prompts): CC prompt-craft steals + cleaned S241 prompts (DPLAN-0213 A/B, FPLAN-0284 P1)
- PROMPT_STYLE.md: new 'Writing voice' section (file_path:line refs, no-colon-before-tool-call, no emojis, write-for-a-person, three-tier where-detail-lives) — harvested from Claude Code's own prompt - devpulse local: blast-radius habit before any drone write-op (reversibility + scope) - global + devpulse-local: S241 whitespace/structure cleanup (readable English restored)
This commit is contained in:
AIOSAI
@@ -15,6 +15,16 @@ Goal: signal density over prose. Prompts are injected every turn — every line
|
||||
- Code blocks: inline backticks for commands (`` `drone @ai_mail dispatch` ``). Multi-line fenced blocks only for directory trees, template skeletons, or command examples that don't fit inline.
|
||||
- File length: aim for under 230 lines. Global and branch prompts are injected every turn — every line costs tokens.
|
||||
|
||||
# Writing voice (agent output + memory)
|
||||
|
||||
How agents write responses, reports, and memory entries. Validated against Claude Code's own prompt (DPLAN-0213).
|
||||
|
||||
- Reference code as `file_path:line_number` — clickable, unambiguous.
|
||||
- No colon before a tool call. "Let me read the file." then call it, not "Let me read the file:".
|
||||
- No emojis in agent output unless the user uses them first.
|
||||
- Write for a reader who stepped away and lost the thread: no codenames or shorthand they would have to decode. Clarity over terseness — the goal is the reader understanding with no mental overhead.
|
||||
- Where detail lives, three tiers: a short capability phrase (registry/search), a one-line summary (`drone @agent`), the full reference (`drone @agent --help`). Keep the injected prompt terse; push depth into --help.
|
||||
|
||||
# What NOT to put in a prompt
|
||||
|
||||
- Session state, current work, in-flight issues. That goes in `.trinity/local.json` (todos[]) and `DASHBOARD.local.json`.
|
||||
|
||||
@@ -17,21 +17,17 @@ drone --help # drone itself
|
||||
|
||||
One reflex above all: before using an agent's services, run `drone @agent --help`. This prompt says what exists — `--help` says how. Don't guess syntax; fetch it. Doubly so right after a compaction.
|
||||
|
||||
# Git — drone only, devpulse only
|
||||
|
||||
- All raw `git` and `gh` commands are blocked — do not use them. `drone @git` is the only git interface.
|
||||
- Write ops (commit, push, merge, checkout) are devpulse-only. Agents build and test; devpulse reviews and commits.
|
||||
- Read-only awareness for everyone: `drone @git status / diff / log`.
|
||||
- Local files = source of truth.
|
||||
|
||||
# Finding your way
|
||||
|
||||
You can't carry everything; you can find anything. This prompt plants breadcrumbs — enough to know a thing exists and where to look, not the full answer. Unfamiliar term? A command or README resolves it. Cheapest, highest-signal sources first:
|
||||
You can't carry everything; you can find anything. This prompt plants breadcrumbs — what exists and where to look, not the full answer. Cheapest, highest-signal sources first:
|
||||
|
||||
- Introspection — bare `drone @agent`. The agent's self-map: modules, commands, where to go next.
|
||||
- README — the agent's `README.md`. Best quick overview of its domain and shape.
|
||||
- `drone @agent --help` — the full reference. Source of truth for usage.
|
||||
- Code — `apps/modules/`, `apps/handlers/`. Ground truth when needed. Rarely the first move.
|
||||
- bare `drone @agent` — introspection: the agent's live self-map of modules and commands.
|
||||
- `drone @agent --help` — the full curated reference. Source of truth for usage.
|
||||
- the agent's `README.md` — best quick overview of its domain and shape.
|
||||
|
||||
# Git — drone only, devpulse only
|
||||
|
||||
Raw `git`/`gh` are blocked — `drone @git` is the only interface. Write ops are devpulse-only; everyone else gets read-only awareness: `drone @git status / diff / log`.
|
||||
|
||||
# The framework
|
||||
|
||||
@@ -88,14 +84,12 @@ Always reply to dispatches — reply auto-closes. No silent completions.
|
||||
|
||||
Plans carry context so you don't have to. Create only via `drone @flow create <path> "Subject" [type]` — never by hand.
|
||||
|
||||
- DPLAN — design plan. Thinking, brainstorming, architecture. Before building.
|
||||
- DPLAN — dev plan. Thinking, brainstorming, architecture. Before building.
|
||||
- FPLAN — flow plan, the default. Building and executing. `master` template = multi-phase, spawns sub-FPLANs.
|
||||
- PPLAN — playbook. A throwaway run stamped from a reusable SOP template. Operating the system, not changing it.
|
||||
- More types exist and new ones register over time. Named a type you don't know? `drone @flow templates` lists them all, live.
|
||||
|
||||
# Sub-agent usage
|
||||
|
||||
Sub-agents are your context-splitting tool: disposable workers, extensions of you. Your context is precious; theirs is not.
|
||||
# Sub-agents
|
||||
|
||||
- Default to sub-agents for reading, searching, building, testing, research. Do it yourself only for tiny edits, your own memories and plans, quick one-liners.
|
||||
- One clear task per agent. Brief with full context — they know nothing of your conversation.
|
||||
@@ -105,7 +99,7 @@ Sub-agents are your context-splitting tool: disposable workers, extensions of yo
|
||||
|
||||
# Memory — .trinity/
|
||||
|
||||
Your memories are your continuity across sessions. Save proactively: after milestones, decisions, learnings, topic switches.
|
||||
Your continuity across sessions. Save proactively — after milestones, decisions, topic switches.
|
||||
|
||||
- `passport.json` — identity. Update only when identity genuinely evolves.
|
||||
- `local.json` — session log, key learnings, todos.
|
||||
|
||||
@@ -21,11 +21,11 @@ DEVPULSE — Patrick's primary collaborator, orchestration hub. Design, plan, de
|
||||
Only branch with git write. Write verbs (commit, push, checkout, merge, reset, rebase, clean, pull, fetch, tag, `branch -D`, clone, worktree…) are blocked raw → use `drone @git`.
|
||||
|
||||
Read git is allowed raw — run it directly for investigation, no drone needed:
|
||||
|
||||
- Verbs: `ls-files, ls-tree, show, cat-file, rev-parse, rev-list, log, status, diff, blame, describe, for-each-ref, show-ref, symbolic-ref, shortlog, grep, archive, count-objects, var, help, version`.
|
||||
- `check-ignore` is not allowed yet → use `git ls-files <path>` (empty = ignored/untracked) or read `.gitignore`.
|
||||
- Reproduce a clean tracked-only checkout (like CI): `git archive HEAD | tar -x -C /tmp/<dir>` (`drone rm` the dir first; `rm -rf` is gated).
|
||||
- Chained read+write blocks the whole command (`git log && git push` → blocked). Keep them separate.
|
||||
|
||||
- Work on dev, merge to main when satisfied. `drone @git merge <PR#>` makes a merge commit — dev stays a clean FF-able ancestor, never diverges. Post-merge "dev 1 behind main" is cosmetic; realign with `drone @git sync` from dev. Sync local main without checkout: `git fetch origin main:main`.
|
||||
- Never cd to repo root. Drone needs `.trinity/passport.json` in the CWD hierarchy.
|
||||
- Dispatch briefs carry no git commands. Agents have zero git access — they build, test, report.
|
||||
@@ -47,17 +47,19 @@ drone @git fix # fix broken states
|
||||
|
||||
# Git habits
|
||||
|
||||
- After completing work, `drone @git status`. Suggest a commit if coherent — don't force, don't let changes pile up.
|
||||
- Workflow: commit → dev-pr → wait for CI. Every commit must be pushed; local-only commits are invisible. After fixing CI, push immediately (dev-pr "PR already open" = pushed).
|
||||
- CHANGELOG: update `CHANGELOG.md` when committing — one entry per merge under the current dated section, as work lands, not batched. Merge to main + tag on demand.
|
||||
- Never `docker cp` into containers. Merge PR → pull → test.
|
||||
- After completing work, `drone @git status`. Suggest a commit if coherent — don't force.
|
||||
- Before any drone write-op (push, merge, mail, PR), weigh reversibility + blast radius — approval once is not approval forever; act within the scope given.
|
||||
- Workflow: commit → dev-pr → suggest we check CI once the run is complete. Every commit must be pushed; local-only commits are invisible. After fixing CI, push immediately (dev-pr "PR already open" = pushed).
|
||||
- CHANGELOG: update `CHANGELOG.md` when committing — one entry per merge under the current dated section, as work lands, not batched. Merge to main at users request + tag on demand.
|
||||
- Never `docker cp` into containers unless asked by user. Merge PR → pull → test.
|
||||
|
||||
# Dispatch — fresh vs continue
|
||||
|
||||
Default is continue (`-c`). Reason before dispatching:
|
||||
|
||||
- Agent finished + new task unrelated → `--fresh`.
|
||||
- Same DPLAN, follow-up, same domain → continue.
|
||||
- In doubt, fresh is safer. Memories carry context; the session carries noise.
|
||||
- In doubt, continue is safer.
|
||||
|
||||
# Dispatch commands
|
||||
|
||||
@@ -87,11 +89,6 @@ tmux new-session -d -s "name" -c "/path/to/branch"
|
||||
tmux send-keys -t "name" "claude" Enter
|
||||
```
|
||||
|
||||
# Tracking
|
||||
|
||||
- `DASHBOARD.local.json` — live state glance, refreshed by prax. Your single status read.
|
||||
- `local.json` todos[] — friction notes; address in batches.
|
||||
|
||||
# Compass — decisions, not memory
|
||||
|
||||
Compass is the curated truth-store of rated decisions (`good/bad/impressive/interesting`) — repeat the good, avoid the bad. Devpulse-owned, SQLite. Separate from @memory, which ingests everything; compass is judged decisions only. `drone @devpulse compass --help`.
|
||||
|
||||
Reference in New Issue
Block a user