Imported from maximebrmd/feldra (
AGENTS.md). Install upstream withnpx skills add maximebrmd/feldra. Copyright stays with the author.
Project agent memory
This file is the project's committed home for project-intrinsic agent knowledge: build, test, release, architecture, and sharp-edge notes that should travel with the code.
- Add durable project-specific notes here as they are discovered through real work.
- Published initializer is
feldraatpackages/feldra(npx feldra create). Root package.json is privatefeldra-monorepo. Stay on 0.1.0 until an explicit public npm release; do not merge Changesets version PRs that bump past 0.1.0 while unpublished. See.github/CONTRIBUTING.mdanddocs/releasing.md. - Auth overlays live in
packages/feldra/variants/{clerk,authjs,supabase}and are applied throughauthOverlaysinpackages/feldra/bin/apply-auth.mjs.scripts/pack-initializer.mjshashes each as{name}Filesintemplate-manifest.json.--authand--databaseare independent; Supabase Auth still needs a project URL and publishable key. - Generated projects choose a docs framework at create time (
--docs blume|mintlify|fumadocs, defaultblume). This monorepoapps/docsstays Blume and is not dual-maintained. Overlay sources live inpackages/feldra/variants/docs. - Root workspaces are limited to
apps/docsandpackages/feldra; generated app/package sources live underpackages/feldra/template-sourceandscripts/pack-initializer.mjsmaps them into the generated project. - After clone/
npm ci,packages/feldra/template/is gitignored untilnpm run initializer:pack. Localfeldra createauto-packs a missing template from this checkout; published packages already include it.
Maintaining this file
Keep this file for knowledge useful to almost every future agent session in this project. Do not repeat what the codebase already shows; point to the authoritative file or command instead. Prefer rewriting or pruning existing entries over appending new ones. When updating this file, preserve this bar for all agents and keep entries concise.