learning_ai_common_plat

bytelyst/learning_ai_common_plat

Fork 0

Commit Graph

Author	SHA1	Message	Date
saravanakumardb1	88b57478aa	feat(drift-check): forbid per-tool subdirectory AGENTS.md duplicates Extends scripts/check-agent-docs-drift.sh to catch a second class of agent-doc drift: per-tool subdirectory duplicates introduced by an earlier 'centralize AI agent documentation references' refactor. The refactor (visible in learning_ai_clock origin/main, commit c73fda7) created .claude/AGENTS.md, .cline/AGENTS.md, .cursor/AGENTS.md as 1-line redirect pointers, plus .devin/AGENTS.md (218 lines) and .devin/CONTEXT.md (206 lines) with full duplicate documentation. All five duplicate the canonical repo-root AGENTS.md. The drift check now exits 1 if any of those five paths exist in any repo listed in repos.txt. Also renumber comment markers (was 1..5, now 1..6) and update the header comment. Verified: bash scripts/check-agent-docs-drift.sh exits 0 with '17 repos in sync' across the ecosystem.	2026-05-23 13:07:26 -07:00
saravanakumardb1	c04ee5f054	feat(agent-docs): single-source-of-truth pattern for agent instructions Establish a single canonical source for ecosystem-wide AI agent behavior rules, eliminating duplication across the 8 agent-config files that each repo used to maintain. New canonical sources (this repo only): - AI.dev/SKILLS/agent-behavior-guidelines.md (Karpathy + ByteLyst rules) - AI.dev/SKILLS/agent-onboarding.md (read-order index) Generator rewrite (scripts/update-agent-docs.sh): - Deletes legacy files that duplicated AGENTS.md: .cursorrules, .windsurfrules, .clinerules, CLAUDE.md - Regenerates .github/copilot-instructions.md as a thin pointer (no rules). - Regenerates .aider.conf.yml and .editorconfig. - Idempotently prepends a canonical-behavior-pointer block to AGENTS.md. - Supports --dry-run and --no-commit flags. Drift check (scripts/check-agent-docs-drift.sh): - Fast marker-based check across all repos. - Verifies legacy files absent, AGENTS.md pointer present, copilot/aider/ editorconfig markers intact. Workflow doc updated: .windsurf/workflows/repo_update-agent-docs.md Repos.txt: added learning_ai_talk2obsidian (was missing from canonical list). This repo's own agent files are migrated by the same generator: - Removed: .cursorrules, .windsurfrules, .clinerules, CLAUDE.md - Updated: AGENTS.md (pointer block prepended) - Updated: .github/copilot-instructions.md (rewritten as pointer) - Updated: .aider.conf.yml (canonical format) Karpathy attribution: behavior rules adapted from https://github.com/multica-ai/andrej-karpathy-skills	2026-05-23 11:55:19 -07:00

Author

SHA1

Message

Date

saravanakumardb1

88b57478aa

feat(drift-check): forbid per-tool subdirectory AGENTS.md duplicates

Extends scripts/check-agent-docs-drift.sh to catch a second class of
agent-doc drift: per-tool subdirectory duplicates introduced by an
earlier 'centralize AI agent documentation references' refactor.

The refactor (visible in learning_ai_clock origin/main, commit c73fda7)
created .claude/AGENTS.md, .cline/AGENTS.md, .cursor/AGENTS.md as 1-line
redirect pointers, plus .devin/AGENTS.md (218 lines) and .devin/CONTEXT.md
(206 lines) with full duplicate documentation. All five duplicate the
canonical repo-root AGENTS.md.

The drift check now exits 1 if any of those five paths exist in any
repo listed in repos.txt. Also renumber comment markers (was 1..5,
now 1..6) and update the header comment.

Verified: bash scripts/check-agent-docs-drift.sh exits 0 with
'17 repos in sync' across the ecosystem.

2026-05-23 13:07:26 -07:00

saravanakumardb1

c04ee5f054

feat(agent-docs): single-source-of-truth pattern for agent instructions

Establish a single canonical source for ecosystem-wide AI agent behavior
rules, eliminating duplication across the 8 agent-config files that each
repo used to maintain.

New canonical sources (this repo only):
- AI.dev/SKILLS/agent-behavior-guidelines.md  (Karpathy + ByteLyst rules)
- AI.dev/SKILLS/agent-onboarding.md           (read-order index)

Generator rewrite (scripts/update-agent-docs.sh):
- Deletes legacy files that duplicated AGENTS.md:
    .cursorrules, .windsurfrules, .clinerules, CLAUDE.md
- Regenerates .github/copilot-instructions.md as a thin pointer (no rules).
- Regenerates .aider.conf.yml and .editorconfig.
- Idempotently prepends a canonical-behavior-pointer block to AGENTS.md.
- Supports --dry-run and --no-commit flags.

Drift check (scripts/check-agent-docs-drift.sh):
- Fast marker-based check across all repos.
- Verifies legacy files absent, AGENTS.md pointer present, copilot/aider/
  editorconfig markers intact.

Workflow doc updated: .windsurf/workflows/repo_update-agent-docs.md

Repos.txt: added learning_ai_talk2obsidian (was missing from canonical list).

This repo's own agent files are migrated by the same generator:
- Removed: .cursorrules, .windsurfrules, .clinerules, CLAUDE.md
- Updated: AGENTS.md (pointer block prepended)
- Updated: .github/copilot-instructions.md (rewritten as pointer)
- Updated: .aider.conf.yml (canonical format)

Karpathy attribution: behavior rules adapted from
https://github.com/multica-ai/andrej-karpathy-skills

2026-05-23 11:55:19 -07:00

2 Commits