crewkit 1.1.4 → 1.1.6

package/README.md

@@ -94,10 +94,9 @@ npx crewkit add impact         # analise de blast radius
 ## IDEs suportadas
 
 - **Claude Code** — suporte completo (agents, skills, hooks, rules, memory)
-- **GitHub Copilot** — auto-detectado, gera `copilot-instructions.md`, agents e prompts
-- **Cursor** — auto-detectado, gera rules com globs e `AGENTS.md`
+- **GitHub Copilot** — gera `copilot-instructions.md`, agents, skills nativas, prompts, instructions por stack e guardrails de seguranca
 
-A IDE e detectada automaticamente durante o setup. `.ai/memory/` e compartilhado entre todas as IDEs.
+A IDE e selecionada pelo usuario durante o setup. `.ai/memory/` e compartilhado entre as IDEs.
 
 ## O que e commitado vs ignorado
 
@@ -111,7 +110,7 @@ A IDE e detectada automaticamente durante o setup. `.ai/memory/` e compartilhado
 ## Requisitos
 
 - Node.js >= 20
-- Claude Code, GitHub Copilot ou Cursor
+- Claude Code ou GitHub Copilot
 - Opus ou Sonnet recomendado (Haiku funciona mas gera scans mais rasos)
 
 ## Licenca
@@ -216,10 +215,9 @@ npx crewkit add impact         # blast radius analysis
 ## Supported IDEs
 
 - **Claude Code** — full support (agents, skills, hooks, rules, memory)
-- **GitHub Copilot** — auto-detected, generates `copilot-instructions.md`, agents and prompts
-- **Cursor** — auto-detected, generates rules with globs and `AGENTS.md`
+- **GitHub Copilot** — generates `copilot-instructions.md`, agents, native skills, prompts, per-stack instructions and security guardrails
 
-IDE is auto-detected during setup. `.ai/memory/` is shared across all IDEs.
+IDE is selected by the user during setup. `.ai/memory/` is shared across IDEs.
 
 ## What gets committed vs ignored
 
@@ -233,7 +231,7 @@ IDE is auto-detected during setup. `.ai/memory/` is shared across all IDEs.
 ## Requirements
 
 - Node.js >= 20
-- Claude Code, GitHub Copilot, or Cursor
+- Claude Code or GitHub Copilot
 - Opus or Sonnet recommended (Haiku works but produces shallower scans)
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crewkit",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Context engineering framework for AI-assisted development. One command to set up agents, skills, hooks, rules, and memory for your project.",
   "type": "module",
   "bin": {
@@ -20,7 +20,6 @@
     "ai",
     "claude-code",
     "copilot",
-    "cursor",
     "agents",
     "skills",
     "mcp",

package/skill/SKILL.md

@@ -15,7 +15,7 @@ This skill scans the current project's codebase and generates a complete, calibr
 
 ### Critical rules (read before starting)
 1. **Language:** All generated files MUST be in **English**. User-facing output (reports during execution) matches the user's language.
-2. **Zero questions:** Do not pause for user input except for re-run detection ([R]/[M]/[C]).
+2. **Zero questions:** Do not pause for user input except for re-run detection ([R]/[M]/[C]) and IDE target selection.
 3. **Validate everything:** After all files are generated, run the completion checklist at the bottom of this document before reporting done.
 4. **Persist to disk:** Write scan results to `.crewkit/` files at each phase. Read them back before generating. This survives context compaction.
 
@@ -40,6 +40,21 @@ Check if `.crewkit/version` exists.
 
 Wait for user choice. On [R] or [M]: existing `lessons-*.md` files with content are **preserved and merged**, not overwritten — these contain accumulated institutional knowledge.
 
+### 3. IDE target selection
+
+**Always ask the user which IDEs to generate context for.**
+
+Check if a previous selection exists in `.crewkit/scan-phase1-recon.md`. If it does, show it as the default.
+
+> "Which IDEs should I generate context for?"
+> - **[1] Claude Code**
+> - **[2] GitHub Copilot**
+> - **[A] All of the above**
+>
+> You can select multiple (e.g., "1,2"). Default: [previous selection if re-run, or "1" if first run].
+
+Accept the user's choice. If the user presses Enter without typing, use the default.
+
 ---
 
 ## Phase 0 — Preparation
@@ -51,16 +66,32 @@ If `.claude/` or `CLAUDE.md` or `.ai/memory/` exists:
 3. Report: "Existing setup backed up to `.crewkit-backup/`"
 
 ### Create directory structure
+Create directories based on the **selected IDE targets** from Pre-flight:
+
+**Always:**
+```
+.ai/
+  memory/
+  plans/
+.crewkit/
+```
+
+**If Claude Code is a selected target:**
 ```
 .claude/
   agents/
   hooks/
   rules/
   skills/
-.ai/
-  memory/
-  plans/
-.crewkit/
+```
+
+**If GitHub Copilot is a selected target:**
+```
+.github/
+  agents/
+  instructions/
+  skills/
+  prompts/
 ```
 
 ### Version tracking
@@ -142,24 +173,16 @@ For each stack, detect the build and test commands:
 
 Read `package.json` scripts, CI configs, or Makefiles to find the actual commands used in this project. Prefer project-specific over generic.
 
-### IDE Target Detection
-
-Detect which IDEs are in use or configured in this project:
-
-| IDE | Detection signals |
-|-----|------------------|
-| Claude Code | **Always** — this skill runs inside Claude Code |
-| GitHub Copilot | `.github/` directory exists OR `.github/copilot-instructions.md` found |
-| Cursor | `.cursor/` directory exists OR `.cursorrules` file found |
+### IDE targets
 
-Save all detected IDE targets to the scan data. Example:
+Use the IDE targets selected during Pre-flight (step 3). Include them in the scan data:
 ```
-IDE targets: Claude Code (always), GitHub Copilot (detected: .github/ exists), Cursor (not detected)
+IDE targets selected: [selected IDEs from pre-flight]
 ```
 
 **Store results as: `ReconProfile`** — write to `.crewkit/scan-phase1-recon.md` for persistence.
 
-Report: "Phase 1 complete. Detected: [stacks], [CI], [DBs], [build/test commands]."
+Report: "Phase 1 complete. Detected: [stacks], [CI], [DBs], [build/test commands]. IDE target: [selected IDEs]."
 
 ---
 
@@ -178,10 +201,8 @@ Read existing human-written documentation to understand project context, convent
 **Existing AI context (from any IDE — preserve, don't discard):**
 - Existing `CLAUDE.md` (if backed up from a previous setup)
 - Existing `.ai/memory/` files (if backed up)
-- `.cursorrules` or `.cursor/rules/*.md` (Cursor)
 - `.github/copilot-instructions.md` or `.github/instructions/*.md` (GitHub Copilot)
 - `.github/agents/*.agent.md` (Copilot agents)
-- `AGENTS.md` (Cursor agents)
 
 If any of these exist, read them and extract rules, conventions, and patterns to incorporate into the generated setup. This preserves context engineering work done in other IDEs.
 
@@ -409,8 +430,8 @@ Compile all profiles into a single summary and present it to the user.
 - Test: `[command]`
 - Dev server: `[command]` (if detected)
 
-## IDE Targets
-- [list each detected IDE — e.g., "Claude Code (always), GitHub Copilot (detected: .github/ exists)"]
+## IDE Targets (selected)
+- [list selected IDE targets — e.g., "Claude Code" or "Claude Code, GitHub Copilot"]
 ```
 
 ### Save profile
@@ -437,9 +458,16 @@ This step is critical for large projects where context compaction may have evict
 
 ---
 
-Generate all files in order. This order is designed for **graceful failure** — if the process is interrupted, the user has the most valuable files first.
+Generate files based on the **selected IDE targets** from Phase 1. The generation order is designed for **graceful failure** — if the process is interrupted, the user has the most valuable files first.
 
-**If the user chose [M] (memory only):** generate steps 1-2 (memory + CLAUDE.md), then update the `<!-- crewkit:context-start -->` headers in existing agents (Step 3, header-only — do not overwrite agent body). Stop after that.
+**IDE-conditional generation:**
+- **Step 1** (`.ai/memory/`): ALWAYS — shared across all IDEs.
+- **Steps 2-9** (CLAUDE.md, `.claude/agents/`, `.claude/rules/`, `.claude/settings.json`, `.claude/hooks/`, `.claude/skills/`, `.claude/QUICKSTART.md`, `.mcp.json`): ONLY if **Claude Code** is a selected target.
+- **Step 10** (IDE Adapters): Runs for each non-Claude IDE in the selected targets. Adapters generate directly from scan data + `.ai/memory/` — they do NOT depend on Claude files existing.
+
+If the only selected target is GitHub Copilot, Steps 2-9 are **skipped entirely**. The adapter generates the IDE-native files directly.
+
+**If the user chose [M] (memory only):** generate Step 1 (memory) + the project rules file for the selected IDE (CLAUDE.md / copilot-instructions.md), then update context headers in existing agents. Stop after that.
 
 ### Templates directory
 Templates are located at `~/.claude/skills/crewkit-setup/templates/`. Read them from disk.
@@ -591,6 +619,8 @@ Create empty `lessons-{stack}.md` files for each detected stack.
 
 ### Step 2 — `CLAUDE.md` (AI-generated from scan)
 
+> **Conditional:** Skip this step if Claude Code is NOT a selected IDE target. Jump to Step 10.
+
 Generate the project's root `CLAUDE.md`. This is the most important generated file — it defines the AI's behavior for this project.
 
 **Structure:**
@@ -908,7 +938,6 @@ Read all core skill templates from `~/.claude/skills/crewkit-setup/templates/ski
 - `hotfix/SKILL.md`
 - `explore-and-plan/SKILL.md`
 - `review-pr/SKILL.md`
-
 Copy each skill template to `.claude/skills/[name]/SKILL.md`. **If the template has a `references/` subdirectory, copy it too.**
 
 These skill templates are **stack-agnostic** by design — they reference `.ai/memory/commands.md` for build/test commands and `.ai/memory/` for project context. No variable substitution needed.
@@ -935,6 +964,7 @@ This project uses crewkit for AI-assisted development. Here's how to use it.
 - `/explore-and-plan <feature>` — map a module and plan before coding (recommended for LARGE tasks)
 - `/review-pr [number]` — review a pull request
 
+
 ## How agents work together
 The orchestrator routes work to specialized agents:
 - **explorer** (Sonnet) — finds files, maps dependencies — read-only
@@ -1001,15 +1031,17 @@ For any placeholder tokens, add a comment in the profile or tell the user to fil
 
 ### Step 10 — IDE Adapters
 
-If IDE targets beyond Claude Code were detected in Phase 1 (e.g., GitHub Copilot, Cursor):
+If **GitHub Copilot** is a selected target:
 
-1. For each additional IDE target detected:
-   a. Determine the adapter file path: `~/.claude/skills/crewkit-setup/adapters/{ide}.md`
-      - GitHub Copilot → `adapters/copilot.md`
-      - Cursor → `adapters/cursor.md`
-   b. If the adapter file does not exist: WARN the user ("Adapter file not found for [IDE] — skipping") and continue to the next IDE. Do not fail.
-   c. If the adapter file exists: read it completely, then MANDATORY: follow ALL instructions in it. The adapter reads scan data from `.crewkit/last-scan.md` and uses the already-generated Claude Code files (Steps 1-9) as its source.
-2. If no additional IDE targets were detected, skip this step entirely.
+1. Determine the adapter file path: `~/.claude/skills/crewkit-setup/adapters/copilot.md`
+2. If the adapter file does not exist: WARN the user ("Adapter file not found for Copilot — skipping"). Do not fail.
+3. If the adapter file exists: read it completely, then MANDATORY: follow ALL instructions in it.
+
+**Source of truth for adapters (in priority order):**
+1. If Claude Code files exist (Steps 2-9 were generated): use them as the primary source, converting content to the target IDE format.
+2. If Claude Code files do NOT exist (Claude was not a selected target): generate IDE-native files directly from `.crewkit/last-scan.md` + `.ai/memory/` (Step 1). The adapter instructions describe the expected output format — use scan data to fill in the content instead of reformatting Claude files.
+
+If no non-Claude IDE targets were selected, skip this step entirely.
 
 **Note:** The adapters do NOT duplicate `.ai/memory/` — that directory is shared across all IDEs without transformation.
 
@@ -1022,8 +1054,12 @@ After all generation steps, run the **Completion Checklist** (at the bottom of t
 ```markdown
 # crewkit setup complete
 
-## Generated files
+## IDE target: [selected IDE(s)]
+
+## Generated files (shared)
 - `.ai/memory/` — [N] files (architecture, conventions, commands, testing, lessons, state)
+
+## Generated files (Claude Code) — only if selected
 - `CLAUDE.md` — project rules ([N] hard rules)
 - `.claude/agents/` — 5 agents (explorer, architect, coder, tester, reviewer)
 - `.claude/rules/` — [N] rule files ([list stacks])
@@ -1033,20 +1069,25 @@ After all generation steps, run the **Completion Checklist** (at the bottom of t
 - `.claude/napkin.md` — priorities board
 - `.claude/QUICKSTART.md` — onboarding guide
 - `.mcp.json` — [N] MCP servers
-- Validation: [N]/17 checks passed
+
+## Generated files (GitHub Copilot) — only if selected
+- `.github/copilot-instructions.md` — project rules (no frontmatter, includes session start + quality gate + safety rules)
+- `.github/instructions/` — [N] per-stack instruction files + sensitive-files guardrail
+- `.github/agents/` — 5 agent files (with model, tools, mcp-servers)
+- `.github/skills/` — 4 native skills
+- `.github/prompts/` — 4 IDE fallback prompts
+
+## Validation: [X]/[Y] checks passed
 
 ## Commands detected
 - Build: `[command]`
 - Test: `[command]`
 
-## Recommended MCPs to configure
-[List MCPs with placeholder tokens that need user input]
-
 ## Next steps
-1. Review `CLAUDE.md` and adjust rules as needed
-2. Fill in MCP tokens in `.mcp.json` (if applicable)
-3. Commit the setup: `git add .claude/ .ai/ CLAUDE.md .mcp.json && git commit -m "chore: add crewkit context engineering setup"`
-4. Run `/full-workflow <your-first-task>` to test the setup
+[Adapt next steps to the selected IDE:]
+- Claude Code: "Review CLAUDE.md → run /full-workflow"
+- Copilot: "Review .github/copilot-instructions.md → open Copilot Chat"
+- All: "Commit the setup"
 ```
 
 ---
@@ -1065,27 +1106,36 @@ After all generation steps, run the **Completion Checklist** (at the bottom of t
 
 Before presenting the Final Report, go through EVERY item. Fix failures before reporting.
 
-### Content checks
+### Content checks (shared — always verify)
 - [ ] `.ai/memory/architecture.md` — has constructor/DI signatures table (if project uses DI)
 - [ ] `.ai/memory/conventions.md` — has Design System section (if frontend detected)
 - [ ] `.ai/memory/testing.md` — has Fakes/Stubs inventory table (if test doubles detected)
 - [ ] `.ai/memory/commands.md` — has build + test + dev commands for ALL detected stacks
+
+### Content checks (Claude Code — only if Claude is a selected target)
 - [ ] `CLAUDE.md` — hard rules present, all in English
 - [ ] `.claude/agents/` — all 5 have `crewkit:context-start` header with real project data
 - [ ] `.claude/QUICKSTART.md` — exists with workflow guide
 
-### Validation checks (run these, don't just assume)
+### Validation checks (Claude Code — only if Claude is a selected target)
 - [ ] `.claude/settings.json` — read back, verify valid JSON, has Write(.ai/memory/*), has stack permissions, has MCP permissions (Layer 4)
 - [ ] `.mcp.json` — read back, verify valid JSON, has context7
 - [ ] `.claude/hooks/*.sh` — run `bash -n` on each, all 4 pass syntax check
 - [ ] `.claude/rules/` — at least 1 per detected stack, glob patterns match real files in project
-- [ ] `.claude/skills/` — all 4 core skills have SKILL.md
-
-### Integrity checks
+- [ ] `.claude/skills/` — all 4 core skills have SKILL.md (full-workflow, hotfix, explore-and-plan, review-pr)
+
+### Content checks (Copilot — only if Copilot is a selected target)
+- [ ] `.github/copilot-instructions.md` — exists, **NO frontmatter**, contains hard rules + session start + quality gate + safety rules, no Claude-specific sections
+- [ ] `.github/instructions/` — at least 1 per detected stack with `applyTo:` frontmatter
+- [ ] `.github/instructions/sensitive-files.instructions.md` — exists with glob for `.env*`, `credentials*`, `secrets*`, `*.key`, `*.pem`
+- [ ] `.github/agents/` — 5 agent files with `.agent.md` extension, each has `tools:` with canonical aliases (`read`, `edit`, `search`, `execute`), has `model:` converted to Copilot names, body under 30,000 chars
+- [ ] `.github/agents/coder.agent.md` + `tester.agent.md` — have `mcp-servers:` if `.mcp.json` exists
+- [ ] `.github/skills/` — 4 native skill files with `name:` + `description:` frontmatter
+- [ ] `.github/prompts/` — 4 IDE fallback prompts with `description:` + `agent: "agent"` frontmatter
+
+### Integrity checks (always)
 - [ ] `.crewkit/last-scan.md` — exists with full profile including Domain section
 - [ ] `.crewkit/scan-phase*.md` — all 4 phase files exist with content
 - [ ] No Portuguese in any generated file (only in user-facing output)
-- [ ] If Copilot target detected: `.github/copilot-instructions.md` exists and contains the project hard rules
-- [ ] If Cursor target detected: `.cursor/rules/project.md` exists and has `alwaysApply: true` frontmatter
 
-Report checklist results as: "Validation: X/17 checks passed." If any failed, list which ones and why.
+Count only the checks applicable to the selected IDE targets. Report as: "Validation: X/Y checks passed." If any failed, list which ones and why.