Skip to content

Commit 7fd22ad

Browse files
tablackburnclaude
andcommitted
docs: sync AIM 0.8.14 fixes (contributing folder, gh release notes, Dir row)
Pull the three instruction-file fixes released in AIM 0.8.14: - contributing: point new modules at instruction-templates/, not instructions/ - github-cli: replace --notes with --notes-file + temp-file pattern, add precedence note that releases.instructions.md wins for project releases - shorthand: backfill missing Dir -> Directory row First two surfaced during Copilot review of this PR and filed upstream as tablackburn/ai-agent-instruction-modules#23; third is pre-existing sync drift in instruction-templates/ fixed in the same upstream PR. Bump AGENTS.md to Template Version 0.8.14 and sync date 2026-05-17. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent fbf2bbe commit 7fd22ad

4 files changed

Lines changed: 12 additions & 5 deletions

File tree

AGENTS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
AI agents working in this repository must follow these instructions.
44

5-
Template Version: 0.8.13
5+
Template Version: 0.8.14
66

7-
Last sync: 2026-05-15 (Update this date when syncing from the centralized repository)
7+
Last sync: 2026-05-17 (Update this date when syncing from the centralized repository)
88

99
## Instructions for AI Agents
1010

instructions/contributing.instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Follow existing patterns in the repository:
5656

5757
**For new instruction files:**
5858

59-
- Place in `instructions/` folder
59+
- Place in `instruction-templates/` folder
6060
- Use `.instructions.md` extension
6161
- Include required YAML frontmatter
6262

instructions/github-cli.instructions.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -164,9 +164,15 @@ gh run view <run-id> --log-failed
164164

165165
### Creating Releases
166166

167+
Use `--notes-file` (write notes to a temporary file first) rather than `--notes` to avoid
168+
escaping issues with backticks, backslashes, and quotes. For project releases, the rules in
169+
`releases.instructions.md` take precedence over these examples.
170+
167171
```bash
168-
# Create release from tag
169-
gh release create v1.0.0 --title "Version 1.0.0" --notes "Release notes"
172+
# Create release from tag (write notes to a file first to avoid escaping issues)
173+
printf '## Highlights\n\n- Your release notes here\n' > release-notes.md
174+
gh release create v1.0.0 --title "Version 1.0.0" --notes-file release-notes.md
175+
rm release-notes.md
170176

171177
# Create release with auto-generated notes
172178
gh release create v1.0.0 --generate-notes

instructions/shorthand.instructions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ use full, descriptive words instead of shorthand or abbreviations.
3737
| Err | Error |
3838
| Msg | Message |
3939
| Conn | Connection / Connections |
40+
| Dir | Directory |
4041
| Cmd | Command |
4142
| Svc | Service |
4243
| Cfg | Configuration |

0 commit comments

Comments
 (0)