Skip to content

V25: Generate AGENTS.md in scaffolded projects - #696

Merged
LinuxDevil merged 1 commit into
mainfrom
v25-agents-md
Oct 20, 2026
Merged

LinuxDevil merged 1 commit into
mainfrom
v25-agents-md

Conversation

@LinuxDevil

Copy link
Copy Markdown
Owner

Fixes audit finding DX-11 / STEAL #5 (Vercel competitor audit, 2026-10-19).

What was wrong

lousho init / create-lousho-agent generated no AGENTS.md or CLAUDE.md, so Claude Code / Cursor / Codex users got no project-specific guidance.

What changed

  • src/cli/init/templates.ts: new AGENTS.md (under 60 lines) in every template/provider: file map, the real scripts read from the same scripts() function that builds package.json (package-manager aware), conventions (defineTool + zod input, needsApproval, provider/model, modelSettings.maxTokens, mockModel; the yaml template gets yaml-appropriate guidance), docs links.
  • New CLAUDE.md containing @AGENTS.md (Claude Code's import convention).
  • Existing-dir behaviour unchanged: assertWritable still refuses a non-empty dir, --force overwrites same-named files as before.
  • docs/installation.md mentions the new files.

URLs in AGENTS.md (all return 200, checked with curl): https://lousho.com/llms.txt, /quickstart, /tools, /approvals, /testing.

Tests

templates.test.ts: for all 18 provider x template combos asserts AGENTS.md and CLAUDE.md exist, AGENTS.md <= 60 lines, the listed npm run scripts equal package.json scripts exactly, only lousho.com URLs, key conventions present; plus a pnpm test. Ran tsc, typecheck:tests, lint, test:coverage (412 files pass), fallow (exit 0), docs:llms.

Changelog: lousho init now generates AGENTS.md and a CLAUDE.md (@AGENTS.md) in every scaffolded project.

🤖 Generated with Claude Code

Every lousho init / create-lousho-agent project gets an AGENTS.md (files, the
real npm scripts, conventions, lousho.com docs links) and a CLAUDE.md that
imports it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@LinuxDevil
LinuxDevil merged commit 5a8566e into main Oct 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant