fix: include subdirectory in reference paths in AGENTS.md

The build system now correctly preserves subdirectory paths when
generating the Available References section. For example, files in
references/db/ are now listed as references/db/file.md instead of
just references/file.md.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Pedro Rodrigues
2026-01-28 12:00:10 +00:00
parent 14ee65a982
commit 8248dcbcd9
2 changed files with 23 additions and 21 deletions

View File

@@ -8,7 +8,7 @@ import {
unlinkSync,
writeFileSync,
} from "node:fs";
import { basename, join } from "node:path";
import { basename, join, relative } from "node:path";
import {
discoverSkills,
getSkillPaths,
@@ -327,8 +327,10 @@ function buildSkill(paths: SkillPaths): void {
for (const file of referenceFiles) {
const name = basename(file, ".md");
const prefix = name.split("-")[0];
// Compute relative path from references directory
const relativePath = relative(paths.referencesDir, file);
const group = grouped.get(prefix) || [];
group.push(name);
group.push(relativePath);
grouped.set(prefix, group);
}
@@ -337,7 +339,7 @@ function buildSkill(paths: SkillPaths): void {
const title = section ? section.title : prefix;
output.push(`**${title}** (\`${prefix}-\`):`);
for (const file of files.sort()) {
output.push(`- \`references/${file}.md\``);
output.push(`- \`references/${file}\``);
}
output.push("");
}

View File

@@ -38,34 +38,34 @@ Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md
## Available References
**Connection Pooling** (`conn-`):
- `references/conn-pooling.md`
- `references/db/conn-pooling.md`
**Migrations** (`migrations-`):
- `references/migrations-diff.md`
- `references/migrations-idempotent.md`
- `references/migrations-testing.md`
- `references/db/migrations-diff.md`
- `references/db/migrations-idempotent.md`
- `references/db/migrations-testing.md`
**Performance** (`perf-`):
- `references/perf-indexes.md`
- `references/perf-query-optimization.md`
- `references/db/perf-indexes.md`
- `references/db/perf-query-optimization.md`
**Row Level Security** (`rls-`):
- `references/rls-common-mistakes.md`
- `references/rls-mandatory.md`
- `references/rls-performance.md`
- `references/rls-policy-types.md`
- `references/rls-views.md`
- `references/db/rls-common-mistakes.md`
- `references/db/rls-mandatory.md`
- `references/db/rls-performance.md`
- `references/db/rls-policy-types.md`
- `references/db/rls-views.md`
**Schema Design** (`schema-`):
- `references/schema-auth-fk.md`
- `references/schema-extensions.md`
- `references/schema-jsonb.md`
- `references/schema-realtime.md`
- `references/schema-timestamps.md`
- `references/db/schema-auth-fk.md`
- `references/db/schema-extensions.md`
- `references/db/schema-jsonb.md`
- `references/db/schema-realtime.md`
- `references/db/schema-timestamps.md`
**Security** (`security-`):
- `references/security-functions.md`
- `references/security-service-role.md`
- `references/db/security-functions.md`
- `references/db/security-service-role.md`
---