Skip to content

docs: track big work in GitHub issues - #10

Merged
Bryan Fawcett (bryanfawcett) merged 1 commit into
mainfrom
docs/track-work-in-issues
Oct 4, 2026
Merged

Bryan Fawcett (bryanfawcett) merged 1 commit into
mainfrom
docs/track-work-in-issues

Conversation

@bryanfawcett

Copy link
Copy Markdown
Member

Summary

Adds a Track big work in GitHub issues section to AGENTS.md, worded identically across every repo:

  • substantial builds, migrations, investigations and multi-step tasks get an issue in the owning repo before or as work starts;
  • the issue holds the goal, the owner's decisions, the plan, acceptance criteria, owner-only steps and links;
  • PRs reference their issue; progress and hand-off notes go in issue comments;
  • cross-repo work gets a tracking issue; no secrets or exploitable detail in public issues.

Refs nyuchi/.github#75 — the owner's canonical rule (2026-10-04) for every CLAUDE.md and AGENTS.md.

Docs only; formatted with the org's pinned oxfmt/prettier and checked with markdownlint-cli2.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GHjaH1Vt2dVLWU68iz8tFq

Adds the owner's canonical rule (2026-10-04) that big work is tracked in GitHub issues so another session, agent or person can pick it up.

Refs nyuchi/.github#75

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GHjaH1Vt2dVLWU68iz8tFq
Signed-off-by: Bryan Fawcett <bryan@nyuchi.com>
@bryanfawcett
Bryan Fawcett (bryanfawcett) merged commit 45d53a4 into main Oct 4, 2026
15 checks passed
@bryanfawcett
Bryan Fawcett (bryanfawcett) deleted the docs/track-work-in-issues branch October 4, 2026 01:45
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