Skip to content

docs: align the docs with the board and milestone rules - #70

Merged
TzuH-Hsu merged 6 commits into
mainfrom
chore/69-doc-alignment
Oct 9, 2026
Merged

TzuH-Hsu merged 6 commits into
mainfrom
chore/69-doc-alignment

Conversation

@TzuH-Hsu

@TzuH-Hsu TzuH-Hsu commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

Closes #69

  • AGENTS.md, CONTRIBUTING.md, .github/PROJECT_FIELDS.md, skills/issue-writing: the coarse type is carried by the type:bug / type:feature labels.

  • AGENTS.md, skills/agent-workflow: Ready is computed by the status sync from Start and blocked-by and does not mean an issue can be picked up; In Progress is set when a pull request is linked, not by hand. ADR-0007 gets a partially-superseded status line.

  • docs/adr/README.md: the lifecycle describes "Accepted. Partially superseded : …", and the index matches each ADR's status line.

  • .github/PROJECT_FIELDS.md, CONTRIBUTING.md: milestones are M1–M4, grouping work by delivery checkpoint.

  • docs/setup/bootstrap.md: a note at the top of phase 3 says to decline the v0.1.0 milestone. scripts/bootstrap.sh is unchanged.

  • docs/template-drift.md records these differences and no longer gives a line count.

  • skills/release-management: when no release tag exists yet, the release check lists every commit up to origin/main instead of an empty range (added after the earlier rounds, 861a014).

  • skills/release-management: the check fetches origin and its tags first, and any open p0/p1 defect still present in the release candidate blocks the release, not only one from the newest commits (b13a6e0).

Test plan

  • make verify
  • scripts/bootstrap.sh unchanged

The coarse type is carried by the type:bug / type:feature labels.
Ready is computed by the status sync and does not mean an issue can be
picked up; In Progress is set when a pull request is linked. ADR-0007
is marked partially superseded, and the ADR lifecycle and index show
partial supersession. Milestones are M1-M4. The drift list records
these changes and no longer gives line counts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-08T18:29:30.215933Z b13a6e0 New commits
🔒 Security Review ✅ Completed 2026-10-08T18:28:52.370800Z b13a6e0 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6ae3f9b6f7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/PROJECT_FIELDS.md Outdated
Comment thread docs/adr/README.md
Comment thread skills/issue-writing/SKILL.md
TzuH-Hsu and others added 2 commits October 9, 2026 00:29
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
issue-writing says to add the type:bug / type:feature label for Bug and
Feature issues. milestone-planning describes the M1-M4 checkpoints.
release-management checks open p0/p1 issues before a release instead
of querying a version milestone. The drift list names both skills.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bbff9ee521

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/setup/bootstrap.md Outdated
Comment thread .github/PROJECT_FIELDS.md Outdated
Comment thread skills/release-management/SKILL.md Outdated
Comment thread skills/release-management/SKILL.md Outdated
The ADR skill and template allow "Accepted. Partially superseded
<date>: ...". The issue-writing examples and CONTRIBUTING say to add the
type:bug / type:feature label by hand. The milestone row is named
Delivery checkpoint, and release versions are git tags. The bootstrap
notes cover the v0.1.0 milestone left by earlier runs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b41b9a33fd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread skills/milestone-planning/SKILL.md
Comment thread docs/template-drift.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b41b9a33fd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/PROJECT_FIELDS.md
Comment thread skills/release-management/SKILL.md Outdated
Comment thread docs/adr/README.md
Before the first release `git describe --tags` finds no tag, and the
release check listed an empty commit range. It now lists every commit
up to origin/main in that case.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 861a014dc6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread skills/release-management/SKILL.md
Comment thread skills/release-management/SKILL.md Outdated
An open p0/p1 defect blocks a release while it is still present in what
origin/main would release, even when it came in before the last tag.
The check fetches origin and its tags before computing the commit range.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b13a6e0846

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/setup/bootstrap.md
@TzuH-Hsu
TzuH-Hsu merged commit f9aed76 into main Oct 9, 2026
2 checks passed
@TzuH-Hsu
TzuH-Hsu deleted the chore/69-doc-alignment branch October 9, 2026 02:17
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.

Align docs with the board and milestone rules

1 participant