Skip to content

docs: verify before filing a task, task status lifecycle, default attach+inline images#1

Merged
Antheurus merged 1 commit into
mainfrom
docs/task-lifecycle-and-verify-before-write
Jul 17, 2026
Merged

docs: verify before filing a task, task status lifecycle, default attach+inline images#1
Antheurus merged 1 commit into
mainfrom
docs/task-lifecycle-and-verify-before-write

Conversation

@Antheurus

Copy link
Copy Markdown
Owner

Summary

  • "Create a task" now documents a mandatory pre-write verification step: investigate the actual codebase when the task concerns a project you maintain, web-search when it's an external but checkable fact, and write as-is only for purely personal/subjective items.
  • Image handling in that recipe is now unconditionally "attach every screenshot" (was worded as optional), with a documented upgrade path to inline embed-image when grpc-auth is already set up — never auto-triggers the interactive grpc-auth flow as a side effect of filing a task.
  • New "Move a task through its status lifecycle" recipe: resolve the task id by search when not already known, set status to In Progress on start / Done on finish, verify each write.
  • No personal/account-specific data added — verified via grep before committing, consistent with the existing rule in CLAUDE.md.

Test plan

  • Read through the new "Create a task" and "Move a task through its status lifecycle" sections for clarity
  • Confirm CI passes (docs-only change, no code touched)

…lt to attach+inline images

- "Create a task" now documents a mandatory pre-write check: investigate the actual
  codebase first when the task is about a project you maintain, web-search first when
  it's an external but checkable fact, and write as-is only for purely personal/
  subjective items with nothing to verify.
- Image handling in that recipe is now unconditionally "attach every screenshot" (was
  worded as optional) plus a documented upgrade path to inline embed-image when
  grpc-auth is already set up, without ever auto-triggering the interactive grpc-auth
  flow as a side effect of filing a task.
- New "Move a task through its status lifecycle" recipe: resolve the task id by search
  when not already known, set status to In Progress on start / Done on finish, verify
  each write, same pattern as the create recipe.
@Antheurus
Antheurus merged commit e051c65 into main Jul 17, 2026
1 check passed
@Antheurus
Antheurus deleted the docs/task-lifecycle-and-verify-before-write branch July 17, 2026 19:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant