apt-mcp-agent-setup 1.3.17 → 1.3.19

package/src/templates/GEMINI.md

@@ -180,6 +180,7 @@ Productivity & Utility Skills — tự trigger theo task context:
 | `writing-flow` | "writing beats", "narrative journey", write article step-by-step | Load SKILL.md → Guide user through choice of narrative beats |
 | `raw-idea-collector` | "collect ideas", "writing fragments", ideate outline | Load SKILL.md → Collect heterogeneous claims, vignettes, and thoughts |
 | `draft-shaper` | "shape draft", "edit notes", clean draft to publishable quality | Load SKILL.md → Iterate paragraph by paragraph to edit draft |
+| `humanizer` | "humanize", "remove AI writing", "anti-slop", "viết tự nhiên hơn" | Load SKILL.md → Scrub 33 AI-writing patterns, rewrite to human voice |
 
 BA/QC Skills — tự trigger cho phân tích yêu cầu và testing:
 
@@ -247,9 +248,35 @@ Every user request must pass through the Socratic Gate before ANY tool use or im
 
 ### 🧹 Clean Code (Global Mandatory)
 - **Code**: Concise, direct, no over-engineering. Self-documenting.
+- **Laziness Ladder**: Before writing code, stop at the first rung that holds: YAGNI → Reuse existing → Stdlib → Native platform → Installed dep → One-liner → Minimum viable. The ladder runs AFTER understanding the problem.
+- **Bug Fix**: Root cause, not symptom. Grep every caller, fix the shared function once.
+- **No Bloat**: No unrequested abstractions, no scaffolding "for later", deletion > addition, fewest files.
 - **Testing**: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
 - **Performance**: Measure first. Adhere to current Core Web Vitals standards.
 
+### ✍️ Anti-Slop Writing (Global Mandatory)
+
+When generating **any prose content** (.md, .docx, PRDs, specs, articles, BA docs, commit messages, PR descriptions), automatically apply these rules. No user invocation needed.
+
+**Always avoid:**
+- **AI vocabulary**: delve, tapestry, landscape (abstract), vibrant, crucial, foster, underscore, showcase, pivotal, testament, interplay, intricacies, garner, enhance, enduring
+- **Significance inflation**: "marking a pivotal moment", "serves as a testament", "setting the stage for"
+- **Copula avoidance**: use "is/are/has" not "serves as/stands as/boasts/features"
+- **Em dashes**: replace with periods, commas, colons, or parentheses
+- **Rule of three**: don't force ideas into groups of three
+- **Sycophantic tone**: no "Great question!", "Absolutely!", "I hope this helps!"
+- **Signposting**: no "Let's dive in", "Here's what you need to know", "Without further ado"
+- **Filler phrases**: "In order to" → "To", "Due to the fact that" → "Because", "It is important to note that" → cut
+- **Promotional language**: no "groundbreaking", "nestled", "breathtaking", "stunning"
+- **Boldface overuse**: don't mechanically bold every key term
+- **Generic positive conclusions**: end on the last concrete fact, not a send-off
+
+**Always prefer:** plain verbs, specific details over vague claims, varied sentence length, active voice when clearer.
+
+**Scope:** Applies to all prose output. Does NOT apply to code, data, or quoted text. For dedicated rewriting of existing text, use the full `/humanizer` skill with its 33-pattern audit.
+
+> Full pattern reference: `.agents/skills/humanizer/references/patterns.md`
+
 ### 🗺️ Quick Reference
 - **Masters**: `orchestrator`, `project-planner`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `mobile-developer`, `aso-specialist`, `debugger`
-- **Key Skills**: `clean-code`, `brainstorming`, `ui-style-rules`, `mobile-rules`, `web-mockup-gen`, `mobile-mockup-gen`, `stitch-design-flow`, `bug-diagnostics`, `tdd-loop`, `spec-clarification`, `prd-gen`, `task-breakdown`, `prototype`, `aso-router`, `stress-test-plan`, `skill-generator`, `git-safety-guardrails`, `git-hook-setup`, `test-type-migration`, `exercise-scaffold`, `interactive-teaching`, `writing-flow`, `raw-idea-collector`, `draft-shaper`, `project-config-wizard`, `skill-writing-guide`, `architecture-rules`, `solution-decision-map`, `task-implementation`, `git-conflict-resolver`, `workflow-navigator`, `terse-communication`, `session-handoff`
+- **Key Skills**: `clean-code`, `brainstorming`, `ui-style-rules`, `mobile-rules`, `web-mockup-gen`, `mobile-mockup-gen`, `stitch-design-flow`, `bug-diagnostics`, `tdd-loop`, `spec-clarification`, `prd-gen`, `task-breakdown`, `prototype`, `aso-router`, `stress-test-plan`, `skill-generator`, `git-safety-guardrails`, `git-hook-setup`, `test-type-migration`, `exercise-scaffold`, `interactive-teaching`, `writing-flow`, `raw-idea-collector`, `draft-shaper`, `humanizer`, `project-config-wizard`, `skill-writing-guide`, `architecture-rules`, `solution-decision-map`, `task-implementation`, `git-conflict-resolver`, `workflow-navigator`, `terse-communication`, `session-handoff`

package/src/templates/copilot-instructions.md

@@ -192,6 +192,9 @@ Every user request must pass through the Socratic Gate before ANY implementation
 
 ### Clean Code (Global Mandatory)
 - **Code**: Concise, direct, no over-engineering. Self-documenting.
+- **Laziness Ladder**: Before writing code, stop at the first rung that holds: YAGNI → Reuse existing → Stdlib → Native platform → Installed dep → One-liner → Minimum viable. The ladder runs AFTER understanding the problem.
+- **Bug Fix**: Root cause, not symptom. Grep every caller, fix the shared function once.
+- **No Bloat**: No unrequested abstractions, no scaffolding "for later", deletion > addition, fewest files.
 - **Testing**: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
 - **Performance**: Measure first. Adhere to current Core Web Vitals standards.
 

package/src/templates/cursorrules.mdc

@@ -197,9 +197,25 @@ Every user request must pass through the Socratic Gate before ANY implementation
 
 ### Clean Code (Global Mandatory)
 - **Code**: Concise, direct, no over-engineering. Self-documenting.
+- **Laziness Ladder**: Before writing code, stop at the first rung that holds: YAGNI → Reuse existing → Stdlib → Native platform → Installed dep → One-liner → Minimum viable. The ladder runs AFTER understanding the problem.
+- **Bug Fix**: Root cause, not symptom. Grep every caller, fix the shared function once.
+- **No Bloat**: No unrequested abstractions, no scaffolding "for later", deletion > addition, fewest files.
 - **Testing**: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
 - **Performance**: Measure first. Adhere to current Core Web Vitals standards.
 
+### Anti-Slop Writing (Global Mandatory)
+
+When generating **any prose content** (.md, .docx, PRDs, specs, articles, BA docs, commit messages, PR descriptions), automatically avoid AI-writing patterns:
+- **Ban list**: delve, tapestry, landscape (abstract), vibrant, crucial, foster, underscore, showcase, pivotal, testament, interplay, intricacies, garner, enhance, enduring
+- **No copula avoidance**: use "is/are/has" not "serves as/stands as/boasts/features"
+- **No em dashes**: replace with periods, commas, colons, or parentheses
+- **No signposting**: no "Let's dive in", "Here's what you need to know"
+- **No filler**: "In order to" → "To", "Due to the fact that" → "Because"
+- **No sycophancy**: no "Great question!", "Absolutely!", "I hope this helps!"
+- **Prefer**: plain verbs, specific details, varied sentence length, active voice
+
+Full 33-pattern reference: `.agents/skills/humanizer/references/patterns.md`
+
 ### Quick Reference
 - **Masters**: `orchestrator`, `project-planner`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `mobile-developer`, `debugger`
-- **Key Skills**: `clean-code`, `brainstorming`, `ui-style-rules`, `mobile-rules`, `web-mockup-gen`, `mobile-mockup-gen`, `stitch-design-flow`, `bug-diagnostics`, `tdd-loop`, `spec-clarification`, `prd-gen`, `task-breakdown`, `prototype`, `stress-test-plan`, `skill-generator`, `git-safety-guardrails`, `git-hook-setup`, `test-type-migration`, `exercise-scaffold`, `interactive-teaching`, `writing-flow`, `raw-idea-collector`, `draft-shaper`, `project-config-wizard`, `skill-writing-guide`, `architecture-rules`, `solution-decision-map`, `task-implementation`, `git-conflict-resolver`, `workflow-navigator`, `terse-communication`, `session-handoff`
+- **Key Skills**: `clean-code`, `brainstorming`, `ui-style-rules`, `mobile-rules`, `web-mockup-gen`, `mobile-mockup-gen`, `stitch-design-flow`, `bug-diagnostics`, `tdd-loop`, `spec-clarification`, `prd-gen`, `task-breakdown`, `prototype`, `stress-test-plan`, `skill-generator`, `git-safety-guardrails`, `git-hook-setup`, `test-type-migration`, `exercise-scaffold`, `interactive-teaching`, `writing-flow`, `raw-idea-collector`, `draft-shaper`, `humanizer`, `project-config-wizard`, `skill-writing-guide`, `architecture-rules`, `solution-decision-map`, `task-implementation`, `git-conflict-resolver`, `workflow-navigator`, `terse-communication`, `session-handoff`

package/src/templates/mcp-tools.md

@@ -95,6 +95,26 @@ Before calling `impact_analysis`:
 
 ---
 
+## 🪜 Code Writing — Laziness Ladder
+
+Before writing ANY code, stop at the **first rung** that holds:
+
+| Rung | Check | Tool to Use | If Yes → |
+|---|---|---|---|
+| 1. YAGNI | Does this need to exist? | Think first | Skip it, explain why in one line |
+| 2. Reuse | Already in codebase? | `explore_code` | Reuse existing helper/util/pattern |
+| 3. Stdlib | Standard library does it? | Language docs | Use stdlib |
+| 4. Platform | Native platform feature? | — | Use it (CSS > JS, `<input type="date">` > picker lib, DB constraint > app code) |
+| 5. Installed dep | Already-installed dependency? | `explore_code` on package.json/pubspec | Use existing dep. No new deps for what a few lines do |
+| 6. One-liner | Can it be one line? | — | One line |
+| 7. Minimum | Only when above fail | — | Write minimum code that works |
+
+**Rule: The ladder runs AFTER understanding the problem. Read the code it touches (`explore_code`), trace the real flow, THEN climb.**
+
+**Bug fix rule: Root cause, not symptom.** Grep every caller (`find_callers`), fix the shared function once — not each caller path.
+
+---
+
 ## 🧠 Memory Conventions — When to Save & Read
 
 ### When to SAVE (`remember`)

package/src/templates/windsurfrules.md

@@ -192,6 +192,9 @@ Every user request must pass through the Socratic Gate before ANY implementation
 
 ### Clean Code (Global Mandatory)
 - **Code**: Concise, direct, no over-engineering. Self-documenting.
+- **Laziness Ladder**: Before writing code, stop at the first rung that holds: YAGNI → Reuse existing → Stdlib → Native platform → Installed dep → One-liner → Minimum viable. The ladder runs AFTER understanding the problem.
+- **Bug Fix**: Root cause, not symptom. Grep every caller, fix the shared function once.
+- **No Bloat**: No unrequested abstractions, no scaffolding "for later", deletion > addition, fewest files.
 - **Testing**: Mandatory. Pyramid (Unit > Int > E2E) + AAA Pattern.
 - **Performance**: Measure first. Adhere to current Core Web Vitals standards.