diff --git a/.claude/agents/stack-maintainer.md b/.claude/agents/stack-maintainer.md index 9770e233a..bb5daa288 100644 --- a/.claude/agents/stack-maintainer.md +++ b/.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 -``` diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index b87d192e2..5db4ef8be 100644 --- a/.github/copilot-instructions.md +++ b/.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 diff --git a/AGENTS.md b/AGENTS.md index 8ee73786c..75953eab9 100644 --- a/AGENTS.md +++ b/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] : -> ` - ## 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 diff --git a/CLAUDE.md b/CLAUDE.md index 4772641da..4dd83692f 100644 --- a/CLAUDE.md +++ b/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. diff --git a/README.md b/README.md index c2120e7eb..5f5d3cb7d 100644 --- a/README.md +++ b/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).