awesome-agv 3.1.0 → 3.3.0

package/README.md

@@ -38,8 +38,8 @@ For example, the principles of the [Rugged Software Constitution](.agents/rules/
 ### Key Features
 
 *   📏 **25 Rules** — covering security, reliability, architecture, and maintainability. Distilled to project-specific decisions only — rules encode *what overrides model defaults*, not what models already know.
-*   🛠️ **57 Skills** — specialized capabilities loaded on demand: language idioms, debugging, design, performance, CI/CD, and more.
-*   🔄 **12 Workflows** — end-to-end development processes from research to ship.
+*   🛠️ **60 Skills** — specialized capabilities loaded on demand: language idioms, debugging, design, testing, performance, CI/CD, and more.
+*   🔄 **10 Workflows** — end-to-end development processes from research to ship, plus specialized testing pipelines.
 *   🤖 **21 Agent Personas** — specialized sub-agents for multi-agent orchestration arranged in a 4-tier hierarchy.
 *   🏗️ **Three-Tier Loading System** — always-on mandates + contextual principles + on-demand skills for zero-noise enforcement.
 
@@ -299,7 +299,7 @@ Activated by the model only when relevant — zero overhead when not applicable.
 *   **[Accessibility Principles](.agents/rules/accessibility-principles.md)**: WCAG 2.1 AA, semantic HTML, keyboard navigation
 *   **[Git Workflow Principles](.agents/rules/git-workflow-principles.md)**: Conventional commits, branch naming, PR hygiene
 
-### Specialized Skills (57)
+### Specialized Skills (60)
 
 Skills are deep expertise modules loaded on demand — agents only pay the token cost when the skill is relevant.
 
@@ -321,6 +321,10 @@ Skills are deep expertise modules loaded on demand — agents only pay the token
 *   **[CI/CD GitOps & Kubernetes](.agents/skills/ci-cd/references/gitops-kubernetes.md)**: ArgoCD, Kubernetes deployment patterns — bundled with `ci-cd`
 *   **[Feature Flags](.agents/skills/feature-flags/SKILL.md)**: Release flags, kill switches, experiment flags, lifecycle rules — PRD-gated, loaded only when required
 
+#### 🧪 Testing Skills
+*   **[Testing Strategy](.agents/skills/testing-strategy/SKILL.md)**: Test doubles strategy, integration test infrastructure (Testcontainers, Firebase emulator), naming conventions, test organization patterns
+*   **[Mobile Testing](.agents/skills/mobile-testing/SKILL.md)**: Mobile E2E testing patterns — Flutter integration_test, Patrol, Maestro, golden testing, device matrix, and test data management
+
 #### 🎨 Design & UI Skills
 *   **[Frontend Design](.agents/skills/frontend-design/SKILL.md)**: Production-grade frontend interfaces, bold aesthetics, typography, motion
 *   **[Mobile Design](.agents/skills/mobile-design/SKILL.md)**: Platform-native mobile interfaces for Flutter and React Native
@@ -334,7 +338,7 @@ Skills are deep expertise modules loaded on demand — agents only pay the token
 *   **[Audit Checklist](.agents/skills/audit-checklist/SKILL.md)**: Consolidated audit checklists for code review and verification — loaded by `/audit` workflow and multi-agent review pipelines.
 *   **[Acceptance Review](.agents/skills/acceptance-review/SKILL.md)**: Spec adherence and deliverable completeness verification — ensures what was delivered matches what was requested.
 
-#### 🌐 Language & Framework Idioms (24)
+#### 🌐 Language & Framework Idioms (26)
 
 Language-specific patterns, tooling, project layout, and quality commands. Each skill auto-loads via `paths:` triggers when the agent touches files in that language.
 
@@ -342,7 +346,7 @@ Language-specific patterns, tooling, project layout, and quality commands. Each
 
 | Skill | Ecosystem | Auto-loads on |
 |---|---|---|
-| [Go Idioms](.agents/skills/go-idioms/SKILL.md) + [layout](./agents/skills/go-idioms/references/project-structure.md) | Go stdlib, error wrapping, table-driven tests, gofumpt | `**/*.go`, `**/go.mod` |
+| [Go Idioms](.agents/skills/go-idioms/SKILL.md) + [layout](.agents/skills/go-idioms/references/project-structure.md) | Go stdlib, error wrapping, table-driven tests, gofumpt | `**/*.go`, `**/go.mod` |
 | [TypeScript Idioms](.agents/skills/typescript-idioms/SKILL.md) + [layout](.agents/skills/typescript-idioms/references/project-structure.md) | Strict mode, type narrowing, Zod, vitest | `**/*.ts`, `**/*.tsx` |
 | [Vue Idioms](.agents/skills/vue-idioms/SKILL.md) + [layout](.agents/skills/vue-idioms/references/project-structure.md) | Vue 3 Composition API, Pinia (Setup Store), composables | `**/*.vue`, `**/store/**/*.ts`, `**/*.store.ts` |
 | [Flutter Idioms](.agents/skills/flutter-idioms/SKILL.md) + [layout](.agents/skills/flutter-idioms/references/project-structure.md) | Riverpod 3, freezed, go_router, const widgets | `**/*.dart`, `**/pubspec.yaml`, `**/analysis_options.yaml` |
@@ -353,20 +357,22 @@ Language-specific patterns, tooling, project layout, and quality commands. Each
 
 | Skill | Ecosystem |
 |---|---|
-| [Angular](.agents/skills/angular-idioms/SKILL.md) | Angular components, signals, DI, RxJS |
+| [Angular](.agents/skills/angular-idioms/SKILL.md) + [layout](.agents/skills/angular-idioms/references/project-structure.md) | Angular components, signals, DI, RxJS |
+| [Axum](.agents/skills/axum-idioms/SKILL.md) | Axum HTTP routing, extractors, Tower middleware |
 | [C++](.agents/skills/cpp-idioms/SKILL.md) | Modern C++ (RAII, smart pointers, CMake) |
 | [C#](.agents/skills/csharp-idioms/SKILL.md) | .NET, async/await, LINQ, records |
 | [Django](.agents/skills/django-idioms/SKILL.md) | Django ORM, views, middleware |
 | [.NET](.agents/skills/dotnet-idioms/SKILL.md) | ASP.NET Core, Entity Framework |
 | [Elixir](.agents/skills/elixir-idioms/SKILL.md) | OTP, GenServer, supervision trees |
+| [Hono](.agents/skills/hono-idioms/SKILL.md) + [layout](.agents/skills/hono-idioms/references/project-structure.md) | Hono routing, middleware, Zod validation, RPC |
 | [Java](.agents/skills/java-idioms/SKILL.md) | Streams, records, sealed classes |
 | [JavaScript](.agents/skills/javascript-idioms/SKILL.md) | ES2024+, async patterns, ESM |
 | [Kotlin](.agents/skills/kotlin-idioms/SKILL.md) | Coroutines, sealed classes, Android |
 | [Laravel](.agents/skills/laravel-idioms/SKILL.md) | Eloquent, middleware, queues |
-| [Next.js](.agents/skills/nextjs-idioms/SKILL.md) | App Router, RSC, ISR |
+| [Next.js](.agents/skills/nextjs-idioms/SKILL.md) + [layout](.agents/skills/nextjs-idioms/references/project-structure.md) | App Router, RSC, ISR |
 | [PHP](.agents/skills/php-idioms/SKILL.md) | PHP 8+, type declarations, Composer |
 | [Rails](.agents/skills/rails-idioms/SKILL.md) | ActiveRecord, conventions, RSpec |
-| [React](.agents/skills/react-idioms/SKILL.md) | Hooks, Suspense, Server Components |
+| [React](.agents/skills/react-idioms/SKILL.md) + [layout](.agents/skills/react-idioms/references/project-structure.md) | Hooks, Suspense, Server Components |
 | [Ruby](.agents/skills/ruby-idioms/SKILL.md) | Blocks, modules, metaprogramming |
 | [Spring Boot](.agents/skills/spring-boot-idioms/SKILL.md) | Spring DI, JPA, WebFlux |
 | [SQL](.agents/skills/sql-idioms/SKILL.md) | Query optimization, indexes, migrations |
@@ -403,26 +409,21 @@ Agent personas are specialized sub-agents designed for multi-agent orchestration
 
 See the [workflow-team](.agents/workflows/workflow-team.md) workflow for the full dispatch protocol, including recursive parallel dispatch with MECE file ownership and DAG-based execution ordering.
 
-### Development Workflows (12)
+### Development Workflows (10)
 
 The setup includes opinionated, end-to-end workflows that chain rules and skills into structured development processes.
 
 #### 🏭 Feature Workflow — Single Agent (`/workflow-solo`)
 
-The primary workflow for a single agent executing all phases sequentially — **no skipping**.
+A lean, single-agent pipeline with adaptive complexity routing. The agent assesses task scope, risk, and knowledge to route into one of three tracks:
 
-```
-Research → Implement (TDD) → Integrate → E2E (conditional) → Verify → Ship
-```
+| Track | When | Pipeline |
+|-------|------|----------|
+| **Light** | All dimensions Low (1–3 files, no breaking changes) | IMPLEMENT → VERIFY → COMMIT |
+| **Standard** | Any dimension Medium/High | RESEARCH → IMPLEMENT → VERIFY → COMMIT |
+| **Thorough** | Multiple dimensions High | RESEARCH → IMPLEMENT → VERIFY (full) → COMMIT |
 
-| Phase        | Phase File                                                     | Purpose                                                                                                                 |
-| ------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| 1. Research  | [`phase-research`](.agents/workflows/phase-research.md)       | Understand context, search docs, create ADRs, uses [Qurio](https://github.com/irahardianto/qurio) default to web search |
-| 2. Implement | [`phase-implement`](.agents/workflows/phase-implement.md)     | TDD cycle: Red → Green → Refactor                                                                                       |
-| 3. Integrate | [`phase-integrate`](.agents/workflows/phase-integrate.md)     | Integration tests with Testcontainers                                                                                   |
-| 3.5. E2E     | [`phase-e2e`](.agents/workflows/phase-e2e.md)                 | End-to-end validation with Playwright                                                                                   |
-| 4. Verify    | [`phase-verify`](.agents/workflows/phase-verify.md)           | Full lint, test, and build validation                                                                                   |
-| 5. Ship      | [`phase-commit`](.agents/workflows/phase-commit.md)           | Git commit with conventional format                                                                                     |
+Each phase references existing rules and skills rather than restating content — the workflow is 133 lines total. Subagent spawning is allowed but not prescribed.
 
 #### 🤖 Multi-Agent Orchestration (`/workflow-team`)
 
@@ -434,6 +435,17 @@ SCOUT → DESIGN → PRE-MORTEM → BUILD (parallel) → REVIEW (parallel) → R
 
 Includes 11 workflow templates (A-K) for common scenarios: full features, bug fixes, audits, mobile features, security hardening, infrastructure, documentation sprints, incident response, and technical debt.
 
+#### 🧪 Testing Workflows
+
+Specialized workflows for retroactive testing improvements on existing codebases:
+
+| Workflow | Pipeline | Purpose |
+|----------|----------|---------|
+| [`/test-unit`](.agents/workflows/test-unit.md) | ANALYZE → PRIORITIZE → REFACTOR → TEST → VERIFY | Coverage-gap-first unit test improvement — analyze gaps, prioritize by business risk and git churn, refactor for testability if needed |
+| [`/test-integration`](.agents/workflows/test-integration.md) | AUDIT → INFRASTRUCTURE → TEST → VERIFY | Adapter audit — scan for I/O boundaries, set up Testcontainers/mocks, write contract-compliance tests |
+| [`/test-e2e`](.agents/workflows/test-e2e.md) | PLAN → SETUP → AUTHOR → EXECUTE → REPORT | Platform-adaptive E2E — web (Playwright) + mobile (Flutter/Patrol/Maestro), journey-based with evidence capture |
+| [`/test-scenarios`](.agents/workflows/test-scenarios.md) | INPUT → INVENTORY → ANALYZE → DERIVE → EXPAND → ORGANIZE → OUTPUT → HUMAN REVIEW | Hybrid structured derivation + mutation-informed expansion — generates prioritized test scenarios that feed into the above workflows |
+
 #### 🔧 Specialized Workflows
 
 | Workflow                                        | When to Use                                          |
@@ -465,7 +477,7 @@ Includes 11 workflow templates (A-K) for common scenarios: full features, bug fi
 │   ├── architectural-pattern.md          # always_on: I/O isolation, testability
 │   ├── rule-priority.md                  # always_on: conflict resolution
 │   └── ...            # 5 more always-on + 15 contextual principles
-├── skills/            # 57 specialized skills — loaded on demand, not always
+├── skills/            # 60 specialized skills — loaded on demand, not always
 │   ├── go-idioms/               # paths: **/*.go — includes references/project-structure.md
 │   ├── typescript-idioms/       # paths: **/*.ts, **/*.tsx
 │   ├── vue-idioms/              # paths: **/*.vue, **/store/**/*.ts, **/*.store.ts
@@ -474,6 +486,9 @@ Includes 11 workflow templates (A-K) for common scenarios: full features, bug fi
 │   ├── python-idioms/           # paths: **/*.py, **/pyproject.toml
 │   ├── testability-patterns/    # reference-loaded from architectural-pattern.md
 │   ├── logging-implementation/  # reference-loaded from logging-and-observability-mandate.md
+│   ├── testing-strategy/        # test doubles, naming, infrastructure patterns
+│   ├── mobile-testing/          # Flutter integration_test, Patrol, Maestro, golden testing
+│   │   └── references/          # flutter.md, maestro.md — framework-specific details
 │   ├── ci-cd/                   # paths: Dockerfile, .github/workflows/*, Jenkinsfile, ...
 │   ├── feature-flags/           # paths: feature*flag*, feature*toggle* (PRD-gated)
 │   ├── debugging-protocol/      # Core engineering (reference-loaded)
@@ -485,15 +500,13 @@ Includes 11 workflow templates (A-K) for common scenarios: full features, bug fi
 │   ├── java-idioms/
 │   ├── incident-response/       # Domain skills
 │   └── ...
-└── workflows/         # 12 development workflows
-    ├── workflow-solo.md          # Composite: single-agent feature workflow
-    ├── workflow-team.md          # Composite: multi-agent pipeline manager
-    ├── phase-research.md         # Phase: understand context
-    ├── phase-implement.md        # Phase: TDD cycle
-    ├── phase-integrate.md        # Phase: integration tests
-    ├── phase-verify.md           # Phase: full validation
-    ├── phase-commit.md           # Phase: git commit
-    ├── phase-e2e.md              # Phase: E2E testing
+└── workflows/         # 10 development workflows
+    ├── workflow-solo.md          # Single-agent: lean adaptive pipeline
+    ├── workflow-team.md          # Multi-agent: hierarchical orchestration
+    ├── test-unit.md              # Testing: unit test coverage improvement
+    ├── test-integration.md       # Testing: integration test coverage
+    ├── test-e2e.md               # Testing: E2E mobile & web
+    ├── test-scenarios.md         # Testing: scenario generator
     ├── bugfix.md                 # Standalone: bug fixes
     ├── refactor.md               # Standalone: code restructuring
     ├── audit.md                  # Standalone: code review
@@ -503,8 +516,8 @@ Includes 11 workflow templates (A-K) for common scenarios: full features, bug fi
 <!-- ROADMAP -->
 ## Roadmap
 
-- [x] Include more specialized skills to aid development process (57 skills shipped).
-- [x] Add development workflows for structured feature delivery (12 workflows shipped).
+- [x] Include more specialized skills to aid development process (60 skills shipped).
+- [x] Add development workflows for structured feature delivery (10 workflows shipped).
 - [x] Add language-specific idiom skills (Go, TypeScript, Vue, Flutter, Rust, Python + 18 community language skills).
 - [x] Create a CLI tool for easier installation (`npx awesome-agv`).
 - [x] Add multi-agent orchestration with 21 specialized agent personas in a 4-tier RMAS hierarchy.
@@ -526,7 +539,7 @@ Awesome AGV ships with **opinionated defaults** for specific technology stacks.
 | **Systems**      | Rust — tokio, thiserror/anyhow, clippy pedantic     | [rust-idioms](.agents/skills/rust-idioms/SKILL.md)               |
 | **Scripting/AI** | Python — ruff, mypy strict, pytest, Pydantic        | [python-idioms](.agents/skills/python-idioms/SKILL.md)           |
 
-**Using a different framework?** The idiom skills are modular — swap or edit them to match your stack. Community language skills are available for Angular, React, Next.js, Spring Boot, Django, Laravel, Rails, and more. See the [Adapting guide](https://irahardianto.github.io/awesome-agv/adapting) for which files to change.
+**Using a different framework?** The idiom skills are modular — swap or edit them to match your stack. Community language skills are available for Angular, React, Next.js, Hono, Axum, Spring Boot, Django, Laravel, Rails, and more. See the [Adapting guide](https://irahardianto.github.io/awesome-agv/adapting) for which files to change.
 
 ## Project Adaptation Guide
 
@@ -540,7 +553,7 @@ This setup supports different project structures:
 | **Microservices**       | Adapt `project-structure.md` per service, add service mesh rules |
 | **Mobile (Flutter/RN)** | Use flutter-idioms or react-idioms skill                        |
 
-**To adapt:** Edit `project-structure.md`, the relevant idiom skill's `references/project-structure.md`, and `phase-verify.md` to match your project layout.
+**To adapt:** Edit `project-structure.md` and the relevant idiom skill's `references/project-structure.md` to match your project layout.
 
 <!-- CONTRIBUTING -->
 ## Contributing

package/agv.config.json

@@ -27,6 +27,7 @@
       "logging-implementation",
       "ml-engineering",
       "mobile-design",
+      "mobile-testing",
       "omni",
       "parallel-dispatch",
       "payment-integration",
@@ -176,6 +177,14 @@
         "detect": ["mix.exs"],
         "skills": ["elixir-idioms"]
       },
+      "hono": {
+        "label": "Hono",
+        "description": "Hono routing, middleware, Zod validation, RPC",
+        "group": "community",
+        "requires": ["typescript"],
+        "detect": [],
+        "skills": ["hono-idioms"]
+      },
       "java": {
         "label": "Java",
         "description": "streams, records, sealed classes",

package/bin/awesome-agv.js

@@ -694,6 +694,35 @@ function writeAgvrc(targetDir, mode, selectedStacks, deselected) {
   fs.writeFileSync(rcPath, JSON.stringify(config, null, 2) + '\n');
 }
 
+// ── Patch .gitignore ───────────────────────────────────────────────────────────
+const AGENTWORK_ENTRY = '.agentwork/';
+
+/**
+ * Ensures .agentwork/ is listed in .gitignore.
+ * Creates .gitignore if it doesn't exist.
+ * Returns: 'created' | 'patched' | 'already_present'
+ */
+function patchGitignore(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+
+  if (!fs.existsSync(gitignorePath)) {
+    fs.writeFileSync(gitignorePath, `${AGENTWORK_ENTRY}\n`, 'utf8');
+    return 'created';
+  }
+
+  const content = fs.readFileSync(gitignorePath, 'utf8');
+  const lines = content.split('\n').map((l) => l.trim());
+
+  if (lines.includes(AGENTWORK_ENTRY)) {
+    return 'already_present';
+  }
+
+  // Append with a preceding newline if the file doesn't end with one
+  const separator = content.endsWith('\n') ? '' : '\n';
+  fs.appendFileSync(gitignorePath, `${separator}${AGENTWORK_ENTRY}\n`, 'utf8');
+  return 'patched';
+}
+
 // ── Read existing .agvrc ───────────────────────────────────────────────────────
 function readAgvrc(targetDir) {
   const rcPath = path.join(targetDir, AGENT_DIR, CONFIG_FILE);
@@ -760,7 +789,7 @@ function readManifest(tarballPath) {
 }
 
 // ── Print Success Summary ──────────────────────────────────────────────────────
-function printSuccess(targetDir, mode, selectedStacks) {
+function printSuccess(targetDir, mode, selectedStacks, gitignoreResult) {
   const agentDir = path.join(targetDir, AGENT_DIR);
   const rulesDir = path.join(agentDir, 'rules');
   const skillsDir = path.join(agentDir, 'skills');
@@ -788,6 +817,16 @@ function printSuccess(targetDir, mode, selectedStacks) {
         ? `${icon.target} Curated`
         : `${icon.gear} Advanced`;
 
+  // Gitignore status message
+  let gitignoreMsg;
+  if (gitignoreResult === 'created') {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} created with ${c.cyan}.agentwork/${c.reset} entry`;
+  } else if (gitignoreResult === 'patched') {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} patched — added ${c.cyan}.agentwork/${c.reset}`;
+  } else {
+    gitignoreMsg = `${icon.check} ${c.bold}.gitignore${c.reset} already contains ${c.cyan}.agentwork/${c.reset}`;
+  }
+
   console.log(`
 ${c.green}${c.bold}  Installation complete! ${icon.rocket}${c.reset}
 
@@ -798,6 +837,8 @@ ${c.green}${c.bold}  Installation complete! ${icon.rocket}${c.reset}
   ${icon.tool}  ${c.bold}${skillsCount}${c.reset} Skills     ${c.dim}Debugging, design, code review, language idioms${c.reset}
   ${icon.cycle}  ${c.bold}${workflowsCount}${c.reset} Workflows  ${c.dim}End-to-end dev processes${c.reset}
   🤖  ${c.bold}${agentsCount}${c.reset} Agents     ${c.dim}Specialized multi-agent personas${c.reset}
+
+  ${gitignoreMsg}
 `);
 
   if (selectedStacks && selectedStacks.size > 0) {
@@ -1005,8 +1046,11 @@ async function main() {
     // ── Write .agvrc ──
     writeAgvrc(options.targetDir, mode, selectedStackKeys, deselected);
 
+    // ── Patch .gitignore ──
+    const gitignoreResult = patchGitignore(options.targetDir);
+
     // ── Success ──
-    printSuccess(options.targetDir, mode, selectedStackKeys);
+    printSuccess(options.targetDir, mode, selectedStackKeys, gitignoreResult);
   } catch (err) {
     console.error(`\n  ${icon.error} ${c.red}Installation failed:${c.reset} ${err.message}\n`);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-agv",
-  "version": "3.1.0",
-  "description": "Selective installer for Awesome AGV — a rugged, high-quality AI Agent configuration suite with 25 rules, 57 skills, 12 workflows, and 21 agent personas.",
+  "version": "3.3.0",
+  "description": "Selective installer for Awesome AGV — a rugged, high-quality AI Agent configuration suite with 25 rules, 59 skills, 12 workflows, and 21 agent personas.",
   "bin": {
     "awesome-agv": "./bin/awesome-agv.js"
   },