Skip to content

Commit f2fd45c

Browse files
tablackburnclaude
andcommitted
feat: deploy AIM (AI Agent Instruction Modules)
Phase 0 of #120 — first PR of the v1.0.0 cycle. - Add AGENTS.md, aim.config.json, and instructions/ with 12 AIM modules (agent-workflow, shorthand, git-workflow, testing, powershell, markdown, readme, github-cli, releases, contributing, update, repository-specific). - Migrate CLAUDE.md content to instructions/repository-specific.instructions.md, keeping only repo-specific content (project layout, $PSBPreference internals, task dependency variables, naming conventions, build workflows, BuildHelpers env vars). Generic content covered by standard AIM modules was dropped to avoid duplication. - Fix stale references during migration: version 0.7.3 -> 0.8.0; public function count 9 -> 12 (signing functions added in 0.8.0). - Delete CLAUDE.md. Docs/config-only — no module code changes. Tests still pass (314 passed, 0 failed, 2 skipped — the skips are git-tagging tests that expectedly skip on feature branches). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 1b16805 commit f2fd45c

15 files changed

Lines changed: 2600 additions & 410 deletions

AGENTS.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# AI Agent Instructions
2+
3+
AI agents working in this repository must follow these instructions.
4+
5+
Template Version: 0.8.13
6+
7+
Last sync: 2026-05-15 (Update this date when syncing from the centralized repository)
8+
9+
## Instructions for AI Agents
10+
11+
AI agents **must**:
12+
13+
1. **When deploying or updating this template, follow `instructions/update.instructions.md` and
14+
update the Last sync date above.**
15+
16+
2. **Read `instructions/agent-workflow.instructions.md` FIRST to determine which other instruction
17+
files apply to your task.** Follow all applicable instructions before proceeding with work.
18+
19+
3. **Check `aim.config.json`** for module configuration and external source settings.
20+
21+
## Instruction Applicability Matrix
22+
23+
Use this matrix to determine which instruction files to read based on your task:
24+
25+
| Task Type | Required Instructions |
26+
| ---------------------------- | -------------------------------------- |
27+
| Any task | `agent-workflow.instructions.md` |
28+
| Any code or documentation | `shorthand.instructions.md` |
29+
| Git operations | `git-workflow.instructions.md` |
30+
| Writing tests | `testing.instructions.md` |
31+
| PowerShell code | `powershell.instructions.md` |
32+
| Documentation | `markdown.instructions.md` |
33+
| README files | `readme.instructions.md` |
34+
| GitHub CLI usage | `github-cli.instructions.md` |
35+
| Creating releases | `releases.instructions.md` |
36+
| Repository-specific work | `repository-specific.instructions.md` |
37+
| Updating instructions | `update.instructions.md` |
38+
| Contributing to upstream | `contributing.instructions.md` |
39+
40+
## Available Instruction Files
41+
42+
- `agent-workflow.instructions.md` - Pre-flight protocol and task workflow
43+
- `shorthand.instructions.md` - Avoid shorthand and abbreviations
44+
- `git-workflow.instructions.md` - Git branching, commits, and PR conventions
45+
- `testing.instructions.md` - Test writing best practices
46+
- `powershell.instructions.md` - PowerShell coding standards
47+
- `markdown.instructions.md` - Markdown formatting standards
48+
- `readme.instructions.md` - README maintenance guidelines
49+
- `github-cli.instructions.md` - GitHub CLI usage guidelines
50+
- `releases.instructions.md` - Release management guidelines
51+
- `repository-specific.instructions.md` - Repository-specific customizations
52+
- `update.instructions.md` - Procedures for updating instructions
53+
- `contributing.instructions.md` - Contributing improvements to upstream
54+
55+
## Quick Reference
56+
57+
### Before Starting Any Task
58+
59+
1. Identify the task type from the matrix above
60+
2. Read all applicable instruction files
61+
3. Follow the guidelines when implementing
62+
63+
### Best Practices
64+
65+
- Follow existing patterns in the codebase
66+
- Keep solutions simple and focused
67+
- Only make changes that are directly requested
68+
- Follow language-specific guidelines
69+
70+
## Repository-Specific Instructions
71+
72+
See `instructions/repository-specific.instructions.md` for customizations specific to this repository.

0 commit comments

Comments
 (0)