paqad-ai 0.1.4 → 0.1.6

package/README.md

@@ -1,6 +1,6 @@
 # paqad-ai
 
-🚀 `paqad-ai` is a documentation-first AI workflow framework for capability-driven repositories. It scaffolds project rules, stack-aware docs, MCP configuration, health checks, and agent entry files so teams can work consistently across Claude Code, Codex CLI, Gemini CLI, and Junie.
+🚀 `paqad-ai` is a documentation-first AI workflow framework for capability-driven repositories. It scaffolds project rules, stack-aware docs, MCP configuration, health checks, and agent entry files so teams can work consistently across Claude Code, Codex CLI, Gemini CLI, Junie, Cursor, GitHub Copilot, Windsurf, Continue, and Aider.
 
 ## ✨ What It Solves
 
@@ -16,12 +16,17 @@ With `paqad-ai`, a repo can:
 
 ## 🧩 Supported Adapters
 
-| Adapter     | Status       | Notes                                                   |
-| ----------- | ------------ | ------------------------------------------------------- |
-| Claude Code | ✅ Supported | Generates `CLAUDE.md` plus MCP config                   |
-| Codex CLI   | ✅ Supported | Generates `AGENTS.md` plus MCP config                   |
-| Gemini CLI  | ✅ Supported | Generates `GEMINI.md` plus MCP config                   |
-| Junie       | ✅ Supported | Limited to `.junie/AGENTS.md` and `.junie/mcp/mcp.json` |
+| Adapter        | Status       | Notes                                                              |
+| -------------- | ------------ | ------------------------------------------------------------------ |
+| Claude Code    | ✅ Supported | Generates `CLAUDE.md` plus MCP config                              |
+| Codex CLI      | ✅ Supported | Generates `AGENTS.md` plus MCP config                              |
+| Gemini CLI     | ✅ Supported | Generates `GEMINI.md` plus MCP config                              |
+| Junie          | ✅ Supported | Limited to `.junie/AGENTS.md` and `.junie/mcp/mcp.json`            |
+| Cursor         | ✅ Supported | Generates `.cursor/rules/paqad.mdc` plus MCP, skills, and agents   |
+| GitHub Copilot | ✅ Supported | Generates `.github/copilot-instructions.md` and `.vscode/mcp.json` |
+| Windsurf       | ✅ Supported | Generates `.windsurfrules` plus MCP, skills, and agents            |
+| Continue       | ✅ Supported | Generates `.continue/rules/paqad.md` plus MCP and prompts          |
+| Aider          | ✅ Supported | Config-only — generates `CONVENTIONS.md`                           |
 
 ## 🛠️ Installation
 
@@ -68,7 +73,7 @@ paqad-ai update --project-root .
 
 Depending on detected capabilities, stack packs, and selected providers, `paqad-ai` can generate:
 
-- provider entry files such as `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, and `.junie/AGENTS.md`
+- provider entry files such as `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.junie/AGENTS.md`, `.cursor/rules/paqad.mdc`, `.github/copilot-instructions.md`, `.windsurfrules`, `.continue/rules/paqad.md`, and `CONVENTIONS.md`
 - framework-managed state under `.paqad/`
 - copied instruction bundles under `docs/instructions/rules/` and `docs/instructions/tools/`
 - stack snapshot docs under `docs/instructions/stack/`
@@ -133,7 +138,7 @@ paqad-ai onboard --project-root .
 
 When run without flags in an interactive terminal, `onboard` prompts for:
 
-1. **Providers** — multi-select: Codex, Claude Code, Gemini, Junie (one or more required).
+1. **Providers** — multi-select: Codex, Claude Code, Gemini, Junie, Cursor, GitHub Copilot, Windsurf, Continue, Aider (one or more required).
 2. **Manifest-driven stack scan** — `composer.json`, `package.json`, lockfiles, and supported config files are scanned first.
 3. **Stack confirmation checkpoint** — the detected effective stack profile is shown and must be confirmed before onboarding continues in interactive mode.
 4. **Fallback stack details** — only shown when detection is missing, ambiguous, or the user chooses to revise. Laravel asks for Inertia, Frontend (None / React.js / Vue.js), Tailwind, Boost, plus Docker/Compose. React asks for app type, Tailwind, and Docker/Compose. Vue asks for app type, Tailwind, and Docker/Compose. Other coding stacks ask for Docker/Compose when supported.
@@ -152,6 +157,12 @@ paqad-ai onboard --project-root . --stack react --capability next tailwind
 
 # Plain Laravel
 paqad-ai onboard --project-root . --stack laravel
+
+# Cursor only
+paqad-ai onboard --project-root . --stack laravel --providers cursor
+
+# GitHub Copilot only
+paqad-ai onboard --project-root . --stack laravel --providers github-copilot
 ```
 
 ### Options
@@ -159,7 +170,7 @@ paqad-ai onboard --project-root . --stack laravel
 - `--project-root <path>`: target project directory. Defaults to the current working directory.
 - `--stack <stack>`: fallback/manual override for the target stack. Values: `laravel`, `flutter`, `react`, `vue`, `django`, `fastapi`, `rails`, `spring-boot`, `express`, `angular`, `svelte`, `astro`, `go-web`, `rust-web`, `short-video`.
 - `--capability <capability...>`: fallback/manual trait override — `inertia`, `react`, `vue`, `tailwind`, `boost`, `next`, `remix`, `vite-spa`, `gatsby`, `nuxt`, `quasar`, `docker`, `compose`, `sail`, `pest`, `phpunit`.
-- `--providers <provider...>`: one or more providers — `codex-cli`, `claude-code`, `gemini-cli`, `junie`.
+- `--providers <provider...>`: one or more providers — `codex-cli`, `claude-code`, `gemini-cli`, `junie`, `cursor`, `github-copilot`, `windsurf`, `continue`, `aider`.
 
 ### Stack capability matrix
 
@@ -273,11 +284,11 @@ Use `update` when the package version changes or when framework-managed scaffold
 | Feature                           | What it does                                                                                                                                                                                                                                                                               |
 | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | 17 built-in stack packs           | Ships 14 framework packs (`laravel`, `flutter`, `react`, `vue`, `django`, `fastapi`, `rails`, `spring-boot`, `express`, `angular`, `svelte`, `astro`, `go-web`, `rust-web`) plus 3 archetype packs (`node-cli`, `node-library`, `node-service`) for projects that don't match a framework. |
-| Multi-provider support            | Generates repo-managed output for Claude Code, Codex CLI, Gemini CLI, and Junie from the same framework state.                                                                                                                                                                             |
+| Multi-provider support            | Generates repo-managed output for Claude Code, Codex CLI, Gemini CLI, Junie, Cursor, GitHub Copilot, Windsurf, Continue, and Aider from the same framework state.                                                                                                                          |
 | Capability-first onboarding       | Starts every repo with `content`, activates `coding` and `security` from matched packs or explicit capability changes.                                                                                                                                                                     |
 | Two-phase stack detection         | Framework packs are evaluated first; archetype packs (`node-cli`, `node-library`, `node-service`) activate as a fallback for CLI tools, libraries, and raw services.                                                                                                                       |
 | Stack Pack architecture           | Uses `pack.yaml` manifests to drive detection, resolver behavior, MCP defaults, pentest mappings, and stack docs. Supports `tier: archetype` for fallback detection.                                                                                                                       |
-| Thin provider entry files         | Generates concise `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.junie/AGENTS.md` files that point to project-owned docs.                                                                                                                                                                    |
+| Thin provider entry files         | Generates concise `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.junie/AGENTS.md`, `.cursor/rules/paqad.mdc`, `.github/copilot-instructions.md`, `.windsurfrules`, `.continue/rules/paqad.md`, and `CONVENTIONS.md` files that point to project-owned docs.                                      |
 | Project-owned instruction bundles | Copies rules and stack references into `docs/instructions/**` so the repo owns the operational guidance.                                                                                                                                                                                   |
 | Stack snapshot docs               | Writes human-readable stack docs under `docs/instructions/stack/**` from detected manifests and lockfiles.                                                                                                                                                                                 |
 | Documentation workflow            | Builds architecture docs, design-system docs, and module docs from the real project state after onboarding.                                                                                                                                                                                |