docs: condense AI instruction files

.claude/agents/stack-maintainer.md

@@ -40,10 +40,3 @@ You are the stack maintainer agent. Your role is to protect the mergeability and
 - Don't write code
 - Keep reviews short and focused
 
-## Example review
-
-```
-🔴 Critical: `.env` file was modified (should be git-ignored)
-🟡 Warning: New import from `users` module into `tasks` module - increases coupling
-🟢 Info: Consider extracting this utility to `core` module for reuse
-```

.github/copilot-instructions.md

@@ -7,30 +7,20 @@
 
 ## Canonical commands
 
-- Dev: `npm run dev` (alias: `npm start`)
-- Build: `npm run build`
-- Preview: `npm run preview`
-- Tests: `npm test` / `npm run test:watch` (watch) or `npm run test:unit` (one-shot)
-- Coverage: `npm run test:coverage`
-- Lint: `npm run lint`
-- Lint fix: `npm run lint:fix`
-- Format: `npm run format`
-- Generate config: `npm run generateConfig`
-- Commit: `npm run commit`
-- Release (CI): `npm run release:auto`
+Scripts: see `package.json` → `scripts` section.
 
 ## Available prompts
 
 Use `.github/prompts/*.prompt.md` for guided workflows:
 
-| Task | Prompt file |
-| ---- | ----------- |
-| Verify | `.github/prompts/verify.prompt.md` |
-| Feature | `.github/prompts/feature.prompt.md` |
+| Task          | Prompt file                               |
+| ------------- | ----------------------------------------- |
+| Verify        | `.github/prompts/verify.prompt.md`        |
+| Feature       | `.github/prompts/feature.prompt.md`       |
 | Create module | `.github/prompts/create-module.prompt.md` |
-| Update stack | `.github/prompts/update-stack.prompt.md` |
-| Naming | `.github/prompts/naming.prompt.md` |
-| PR | `.github/prompts/pull-request.prompt.md` |
+| Update stack  | `.github/prompts/update-stack.prompt.md`  |
+| Naming        | `.github/prompts/naming.prompt.md`        |
+| PR            | `.github/prompts/pull-request.prompt.md`  |
 
 ## Always-on guardrails
 

AGENTS.md

@@ -9,11 +9,6 @@ For architecture, modularity rules, guardrails, naming, commands, and definition
 - Keep changes secure and free of secrets
 - Enforce module boundaries and layered architecture
 
-## Preflight
-
-- Read `ERRORS.md` before proposing changes or code reviews
-- If the AI makes a new recurring mistake, append one line to `ERRORS.md` using `[YYYY-MM-DD] <scope>: <wrong> -> <right>`
-
 ## Codex prompt routing
 
 Use `.github/prompts/*` as task playbooks:
@@ -27,8 +22,3 @@ Use `.github/prompts/*` as task playbooks:
 | Naming | `.github/prompts/naming.prompt.md` |
 | PR | `.github/prompts/pull-request.prompt.md` |
 
-## Review output convention
-
-- `Critical`: must fix before merge (security, breakage, mergeability risk)
-- `Warning`: should be reviewed (coupling, architecture drift)
-- `Info`: non-blocking suggestion

CLAUDE.md

@@ -12,24 +12,7 @@ The `.claude/` folder contains embedded settings, skills, and agents that are av
 
 ## Canonical commands
 
-| Command          | Script                   | Description                                  |
-| ---------------- | ------------------------ | -------------------------------------------- |
-| **Dev**          | `npm run dev`            | Start dev server at `http://localhost:8080/` |
-| **Dev (alias)**  | `npm start`              | Alias for `npm run dev`                      |
-| **Build**        | `npm run build`          | Build for production                         |
-| **Preview**      | `npm run preview`        | Preview production build locally             |
-| **Test**         | `npm test`               | Run tests in watch mode                      |
-| **Test watch**   | `npm run test:watch`     | Run tests in watch mode (explicit alias)     |
-| **Unit test**    | `npm run test:unit`      | Run unit tests once (one-shot)               |
-| **Coverage**     | `npm run test:coverage`  | Generate test coverage                       |
-| **Lint**         | `npm run lint`           | Check code quality                           |
-| **Lint fix**     | `npm run lint:fix`       | Auto-fix linting issues                      |
-| **Format**       | `npm run format`         | Format with Prettier                         |
-| **Config**       | `npm run generateConfig` | Generate config from env vars                |
-| **Migration**    | `npm run check:migration`| Check Vite migration compatibility           |
-| **Commit**       | `npm run commit`         | Commit with commitizen                       |
-| **Release (CI)** | `npm run release:auto`   | Semantic release for CI                      |
-| **Docker**       | `docker-compose up`      | Start with docker-compose                    |
+Scripts: see `package.json` → `scripts` section.
 
 ## Preflight
 
@@ -73,13 +56,7 @@ Use `.claude/skills/*/SKILL.md` as the primary workflow source for Claude.
 
 ## Stack merge workflow
 
-```bash
-git remote add devkit-vue https://github.com/pierreb-devkit/Vue.git
-git fetch devkit-vue
-git merge devkit-vue/master
-```
-
-Resolve conflicts carefully to preserve downstream customizations and keep future merges clean.
+Stack merge: see README — stack merge workflow section.
 
 > Older changelog entries and some tooling references may still mention `weareopensource/Vue` or "WeAreOpenSource" — treat those as historical upstream references only.
 

README.md

@@ -141,22 +141,7 @@ This stack ships preconfigured instruction and prompt files for Claude Code, Git
 
 ### Claude Code — Available Skills
 
-| Skill            | Description                                           |
-| ---------------- | ----------------------------------------------------- |
-| `/verify`        | Run quality loop (lint + test + build)                |
-| `/create-module` | Create new module by duplicating the `tasks` template |
-| `/feature`       | Implement feature following modularity rules          |
-| `/update-stack`  | Merge stack updates into downstream projects          |
-| `/naming`        | Check or apply file and folder naming conventions     |
-| `/pull-request`  | Full PR lifecycle: branch, commit, issue, monitor     |
-
-### Modularity Rules
-
-- Each module should be as **independent** as possible
-- Avoid cross-module imports/coupling
-- Shared code goes in `src/modules/core` with explicit justification
-- Keep config, routes, data-access, and business logic **inside the module boundary**
-- Tests are organized per module: `src/modules/*/tests/`
+Skills available via `/verify`, `/feature`, `/create-module`, `/update-stack`, `/naming`, `/pull-request` — see `.claude/skills/` for details.
 
 ### Stack Merge Workflow
 
@@ -166,6 +151,8 @@ git fetch devkit-vue
 git merge devkit-vue/master
 ```
 
+> Caution: resolve conflicts manually to preserve downstream customizations before pushing.
+
 ## :pencil2: Contribute
 
 Open issues and pull requests on [GitHub](https://github.com/pierreb-devkit/Vue).