| Age | Commit message (Collapse) | Author |
|---|
|
- New skill: skill-maintenance (SKILL.md + 4 references: best-practices,
dry-across-skills, sub-division, audit-checklist) encoding the Agent Skills
spec rules, cross-skill DRY, and the f3s/rocky-vm-setup sub-division pattern.
- agent-task-management/references/verification-honesty.md: canonical home
for the general verification-honesty discipline (linked from go-best-practices).
- blog-writing-style/references/gemtext-conventions.md: shared foo.zone
gemtext conventions (linked from compose-blog-post, update-blog-post,
blog-writing-style).
- blog-writing-style/references/patterns-and-examples.md: foo.zone LLM-pattern
catalog + rewrite examples extracted from blog-writing-style SKILL.md.
- f3s/references/{console-jetkvm-shutdown,shelly-plug}.md: referenced by
f3s/SKILL.md (previously untracked).
|
|
|
|
vendored/upstream deps
A sub-agent patched a vendored dependency (libbpfgo) and the change had to
be reverted. When completing a task appears to require changing a vendored,
generated, or upstream dependency, that is a scope boundary: flag it as a
blocker (annotate + report) instead of patching the dep. Added to
2-start-task.md with a pointer from SKILL.md; cross-references the
complete-task commit hygiene and stalled-worker recovery rather than
restating them.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
|
Extend the complete-task reference with a 'Commit only in-scope files'
section: at task start and before committing, run git status and split
dirty paths into in-scope vs out-of-scope (pre-existing/unrelated user
edits such as .gitignore/start.sh). Stage only in-scope files by explicit
path, never git add -A/. over a pre-existing dirty worktree, never commit
unrelated files, and record the in-scope/out-of-scope decision in an
ask annotate note. Cross-reference 6-recover-stalled-task.md (broken
partial WIP) to keep the two cases distinct and avoid duplication.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
|
Multiple ior/player tasks had a worker stall or get interrupted mid-edit,
leaving broken, uncommitted partial file edits with no documented recovery
path. Add references/6-recover-stalled-task.md covering detect -> assess ->
revert -> resume: how to spot a partial/interrupted edit (dirty worktree,
broken build, half-applied diffs), assess dirty changes against the task
annotations (keep in-scope WIP vs. discard broken edits vs. preserve unrelated
user changes), revert cleanly with scoped git checkout/stash WITHOUT destroying
unrelated work, then re-read annotations, resume from the last known-good
point, and annotate the recovery.
Wire the new reference into SKILL.md's 'When to load what' table and cross-ref
it from 2-start-task.md when picking up an already-started task. Commit
discipline is cross-referenced to 3-complete-task.md rather than duplicated.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
|
invocation contract
Agents repeatedly mistook `ask` for a natural-language interface and ran
things like `ask agent-task-management ...` or `ask <free text>`, forcing
orchestrators to paste the correction into every task description.
- Add a prominent STOP blockquote at the very top of SKILL.md stating that
`ask` is a CLI with fixed subcommands and that agent-task-management is a
skill name, never an `ask` subcommand.
- Add an explicit 'Invocation contract' section listing the only valid form
(`ask <subcommand> [args]`) and the real subcommands, derived from existing
content; consolidate the valid/invalid examples there (DRY) with inline
reasons on the invalid ones.
- Mirror the same STOP warning at the top of references/00-context.md and
tighten its rule to point at the contract.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
|
|
|
Tag names in the ask CLI do not support hyphens (-). Added a clear
note in both the rules section and the Conventions section of
1-create-task.md so agents use camelCase or concatenated words instead.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
|
|
|
|
|
Document running prompts from ~/Notes/Prompts/commands by command name,
placeholder mapping, and positional arguments. Update task-management
skill and references to invoke ~/go/bin/do explicitly.
Made-with: Cursor
|
|
Update SKILL.md and reference docs for the do task CLI; add zsh reserved-word note in 00-context.
Made-with: Cursor
|
|
|
|
|
|
- Orchestrator picks tasks, marks them started, and spawns a sub-agent for implementation
- Each task runs in a clean context; orchestrator never implements tasks directly
- Updated docs to clarify sub-agent delegation and context isolation
- Improved task loop and reporting steps
- See prompts/commands/work-on-tasks.md for new orchestrator/sub-agent workflow
|
|
section with example usage
|
|
|
|
|
|
|
|
|
