From 48666c269e583a0ceab8f67bcd132e8a1ab35973 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 29 Sep 2026 19:31:44 +0000 Subject: [PATCH 1/2] docs: add release blog for PR #146 [skip-release] --- README.md | 2 +- ...s-write-agent-guidance-for-issuetracker.md | 117 ++++++++++++++++++ docs/blogs/README.md | 1 + 3 files changed, 119 insertions(+), 1 deletion(-) create mode 100644 docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md diff --git a/README.md b/README.md index 8a21f6bd..973198ce 100644 --- a/README.md +++ b/README.md @@ -80,6 +80,7 @@ For security concerns, please review our [Security Policy](docs/SECURITY.md). | Version | Date | Title | Blog post | | ------- | ---- | ----- | --------- | +| [v0.0.3](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.3) | 2026-09-29 | docs: Write agent guidance for IssueTracker | [Post](https://github.com/mpaulosky/IssueTracker/blob/main/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md) | | [v0.0.2](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.2) | 2026-09-29 | ci: Gate Test Suite on coverage and let fork PRs pass it | [Post](https://github.com/mpaulosky/IssueTracker/blob/main/docs/blogs/2026-09-29-pr-145-ci-gate-test-suite-on-coverage-and-let-fork-prs-pass-it.md) | | [v0.0.1-1170](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1-1170) | 2026-09-29 | v0.0.1-1170 | — | | [v0.0.1-1169](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1-1169) | 2026-09-29 | v0.0.1-1169 | — | @@ -89,7 +90,6 @@ For security concerns, please review our [Security Policy](docs/SECURITY.md). | [v0.0.1-1165](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1-1165) | 2026-09-29 | v0.0.1-1165 | — | | [v0.0.1-1164](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1-1164) | 2026-09-29 | v0.0.1-1164 | — | | [v0.0.1](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1) | 2026-09-29 | ci: Adopt atelier-store's CI, release and lint setup | [Post](https://github.com/mpaulosky/IssueTracker/blob/main/docs/blogs/2026-09-29-pr-140-ci-adopt-atelier-store-s-ci-release-and-lint-setup.md) | -| [v0.0.1-1163](https://github.com/mpaulosky/IssueTracker/releases/tag/v0.0.1-1163) | 2026-09-28 | v0.0.1-1163 | — | diff --git a/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md b/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md new file mode 100644 index 00000000..f049624f --- /dev/null +++ b/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md @@ -0,0 +1,117 @@ +--- +post_title: "docs: Write agent guidance for IssueTracker" +author1: mpaulosky +post_slug: "v0.0.3-pr-146" +microsoft_alias: n/a +featured_image: "" +categories: + - engineering +tags: + - release:v0.0.3 + - automation +ai_note: "Generated by release automation from the PR title, description, commits and changed files. No AI summary." +summary: "Release notes seed for v0.0.3 from PR #146." +post_date: "2026-09-29" +--- +# docs: Write agent guidance for IssueTracker + +- **Release tag:** `v0.0.3` +- **Source PR:** [#146](https://github.com/mpaulosky/IssueTracker/pull/146) + +## PR description + +### Summary + +Replaces two sets of guidance that didn't describe this repo: the Copilot-era instructions, which described a "TailwindBlogApp" solution, and the files copied from atelier-store, which describe a storefront. + +**New** +- **`CLAUDE.md`** at the root covers: + - the layers and how they connect (the UI calls services only; `Extensions/` is the composition root) + - build, run and test commands, and why the SDK is pinned to 10.0.3xx + - test conventions and code style + - the branch → PR → auto-merge → release workflow +- **`.github/skills/code-review`**: review checks specific to IssueTracker (layering, the `IMemoryCache` invalidation, model/fake/repository drift, `[Authorize]` policies, `-warnaserror`, workflow rules). +- **`blog.instructions.md`**: front matter for the generated posts in `docs/blogs/`. + +**Rewritten for IssueTracker** +- `blazor.instructions.md` (Blazor Server via `_Host.cshtml`, code-behind, `@inject`, Radzen + Bootstrap, Azure AD B2C, DTO-bound forms), `dotnet-project.instructions.md`, and `git-commit-instructions.md` (IssueTracker scopes and examples, fixed code fences). +- `markdown.instructions.md` now uses **one H1 title per file**, resolving the MD041 conflict Copilot flagged on #140. + +**Removed** +- `copilot-instructions.md` (both copies), all 14 prompts, and 9 skills written for other repos. That includes `bunit-test-migration`, which targets bUnit's 1.0 beta API; IssueTracker never used it. The `TestContext` → `BunitContext` migration will get its own guidance. + +**Kept:** `mongo-dba.instructions.md` (long line wrapped). + +markdownlint now covers `.github/` too; the temporary ignores from #140 are gone. + +### Checked against the code + +While writing this I checked each claim against the code, and corrected these: +- Services cache in `IMemoryCache`, not Redis. +- `Architecture.Tests` only enforces part of the layering; the rest is convention. +- The UI project references PlugIns, but only for DI registration. + +### Validation + +- markdownlint-cli2 over the whole repo: 0 issues +- Pre-push `scripts/gate.sh`: lint, build and all test projects pass +- `--filter "FullyQualifiedName~…"` syntax in the instructions verified with a real run + +🤖 Generated with [Claude Code](https://claude.com/claude-code) + +## Commits + +- docs: Write agent guidance for IssueTracker (`a241794`) +- Merge branch 'main' into chore/issuetracker-agent-guidance (`728c177`) +- docs: Correct agent guidance from review (`8874c77`) +- Merge remote-tracking branch 'origin/main' into chore/issuetracker-agent-guidance (`6f121ea`) +- Merge remote-tracking branch 'origin/chore/issuetracker-agent-guidance' into chore/issuetracker-agent-guidance (`c371aab`) +- docs: Scope cache and pinning rules to what the code does (`3acd961`) +- Merge remote-tracking branch 'origin/main' into chore/issuetracker-agent-guidance (`1530212`) + +## Files changed + +### tests/ + +- `tests/IssueTracker.UI.Tests.Unit/IssueTracker.UI.Tests.Unit.csproj` (+3 / -2) + +### .github/ + +- `.github/copilot-instructions.md` (+0 / -193) +- `.github/instructions/blazor.instructions.md` (+39 / -57) +- `.github/instructions/blog.instructions.md` (+19 / -0) +- `.github/instructions/copilot-instructions.md` (+0 / -190) +- `.github/instructions/dotnet-project.instructions.md` (+52 / -0) +- `.github/instructions/git-commit-instructions.md` (+13 / -12) +- `.github/instructions/markdown.instructions.md` (+19 / -49) +- `.github/instructions/mongo-dba.instructions.md` (+3 / -1) +- `.github/prompts/build-repair.prompt.md` (+0 / -62) +- `.github/prompts/copyright-header-update-prompt.md` (+0 / -52) +- `.github/prompts/create-readme.prompt.md` (+0 / -31) +- `.github/prompts/csharp-docs.prompt.md` (+0 / -63) +- `.github/prompts/csharp-xunit.prompt.md` (+0 / -69) +- `.github/prompts/dotnet-best-practices.prompt.md` (+0 / -86) +- `.github/prompts/editorconfig.prompt.md` (+0 / -72) +- `.github/prompts/playwright-explore-website.prompt.md` (+0 / -24) +- `.github/prompts/structured-autonomy-generate.prompt.md` (+0 / -141) +- `.github/prompts/structured-autonomy-implement.prompt.md` (+0 / -22) +- `.github/prompts/structured-autonomy-plan.prompt.md` (+0 / -90) +- `.github/prompts/structured-autonomy.md` (+0 / -68) +- `.github/prompts/xunit-integration.prompt.md` (+0 / -364) +- `.github/prompts/xunit.prompt.md` (+0 / -394) +- `.github/skills/bunit-test-migration/SKILL.md` (+0 / -275) +- `.github/skills/code-review/SKILL.md` (+61 / -0) +- `.github/skills/github-issues/SKILL.md` (+0 / -136) +- `.github/skills/github-issues/references/templates.md` (+0 / -92) +- `.github/skills/microsoft-docs/SKILL.md` (+0 / -56) +- `.github/skills/nuget-manager/SKILL.md` (+0 / -79) +- `.github/skills/prd/SKILL.md` (+0 / -143) +- `.github/skills/refactor/SKILL.md` (+0 / -656) +- `.github/skills/reviewer-protocol/SKILL.md` (+0 / -79) +- `.github/skills/session-recovery/SKILL.md` (+0 / -155) +- `.github/skills/test-discipline/SKILL.md` (+0 / -37) + +### other + +- `.markdownlint-cli2.jsonc` (+0 / -6) +- `CLAUDE.md` (+82 / -0) diff --git a/docs/blogs/README.md b/docs/blogs/README.md index b1117988..01e8360a 100644 --- a/docs/blogs/README.md +++ b/docs/blogs/README.md @@ -4,5 +4,6 @@ This directory contains concise release-review posts for merged PR releases. | Date | Title | Tags | | ---- | ----- | ---- | +| 2026-09-29 | [docs: Write agent guidance for IssueTracker](2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md) | release,automation | | 2026-09-29 | [ci: Gate Test Suite on coverage and let fork PRs pass it](2026-09-29-pr-145-ci-gate-test-suite-on-coverage-and-let-fork-prs-pass-it.md) | release,automation | | 2026-09-29 | [ci: Adopt atelier-store's CI, release and lint setup](2026-09-29-pr-140-ci-adopt-atelier-store-s-ci-release-and-lint-setup.md) | release,automation | From 951070569e34aa8cf3982ed5ab6a780dc14c6be5 Mon Sep 17 00:00:00 2001 From: mpaulosky <60372079+mpaulosky@users.noreply.github.com> Date: Tue, 29 Sep 2026 12:34:31 -0700 Subject: [PATCH 2/2] docs: Name both UI uses of PlugIns in the #146 post [skip-release] --- ...6-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md b/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md index f049624f..e1171fcc 100644 --- a/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md +++ b/docs/blogs/2026-09-29-pr-146-docs-write-agent-guidance-for-issuetracker.md @@ -49,7 +49,7 @@ markdownlint now covers `.github/` too; the temporary ignores from #140 are gone While writing this I checked each claim against the code, and corrected these: - Services cache in `IMemoryCache`, not Redis. - `Architecture.Tests` only enforces part of the layering; the rest is convention. -- The UI project references PlugIns, but only for DI registration. +- The UI project references PlugIns for two things: DI registration in `Extensions/`, and the MongoDB health probe in `Helpers/MongoHealthCheck.cs`. ### Validation