Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 | — |
Expand All @@ -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 | — |

<!-- RELEASES_END -->

Expand Down
Original file line number Diff line number Diff line change
@@ -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 for two things: DI registration in `Extensions/`, and the MongoDB health probe in `Helpers/MongoHealthCheck.cs`.

### 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)
1 change: 1 addition & 0 deletions docs/blogs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Loading