awesome-agv 1.2.2 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +126 -42
  2. package/bin/awesome-agv.js +12 -5
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -38,11 +38,12 @@ For example, the principles of the [Rugged Software Constitution](.agents/rules/
38
38
  ### Key Features
39
39
 
40
40
  * 📏 **42 Rules** — covering security, reliability, architecture, maintainability, language idioms, and DevOps.
41
- * 🛠️ **8 Skills** — specialized capabilities for debugging, design, performance optimization, and more.
42
- * 🔄 **11 Workflows** — end-to-end development processes from research to ship.
41
+ * 🛠️ **43 Skills** — specialized capabilities for debugging, design, performance optimization, language idioms, and more.
42
+ * 🔄 **12 Workflows** — end-to-end development processes from research to ship.
43
+ * 🤖 **15 Agent Personas** — specialized sub-agents for multi-agent orchestration (architect, backend-engineer, security-engineer, etc.).
43
44
  * 🏗️ **Two-Tier Rule System** — always-on mandates + contextual principles for zero-noise enforcement.
44
45
 
45
- > **💡 Everything is modular.** Rules and skills work independently — you don't need workflows to benefit from them. Use only what you need, modify anything, or build your own workflows. It's a toolkit, not a framework.
46
+ > **💡 Everything is modular.** Rules, skills, agents, and workflows work independently — you don't need everything to benefit. Use only what you need, modify anything, or build your own. It's a toolkit, not a framework.
46
47
 
47
48
  <!-- GETTING STARTED -->
48
49
  ## Getting Started
@@ -393,43 +394,117 @@ The power of the setup comes from its extensive collection of rules covering eve
393
394
  * **[Code Completion Mandate](.agents/rules/code-completion-mandate.md)**: Automated quality checks before every delivery.
394
395
  * **[Rule Priority](.agents/rules/rule-priority.md)**: Conflict resolution when rules contradict each other.
395
396
 
396
- ### Specialized Skills
397
+ ### Specialized Skills (43)
397
398
 
399
+ #### 🔧 Core Engineering Skills
398
400
  * **[Debugging Protocol](.agents/skills/debugging-protocol/SKILL.md)**: Systematic approach to solving errors.
399
- * **[Frontend Design](.agents/skills/frontend-design/SKILL.md)**: Guidelines for creating visually appealing UIs, based on [Anthropic Frontend-Design Skills](https://github.com/anthropics/skills/tree/main/skills/frontend-design)
400
- * **[Mobile Design](.agents/skills/mobile-design/SKILL.md)**: Production-grade mobile interfaces for Flutter and React Native.
401
401
  * **[Sequential Thinking](.agents/skills/sequential-thinking/SKILL.md)**: A tool for breaking down complex problems, an adaptation from [Sequential Thinking MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking)
402
402
  * **[Code Review](.agents/skills/code-review/SKILL.md)**: Structured code review protocol against the full rule set.
403
403
  * **[Guardrails](.agents/skills/guardrails/SKILL.md)**: Pre-flight checklist and post-implementation self-review.
404
404
  * **[ADR (Architecture Decision Records)](.agents/skills/adr/SKILL.md)**: Document significant architectural decisions with context and trade-offs.
405
- * **[Performance Optimization](.agents/skills/perf-optimization/SKILL.md)**: Profile-driven performance optimization with Go pprof, frontend Lighthouse, and bundle analysis tooling.
405
+ * **[Performance Optimization](.agents/skills/perf-optimization/SKILL.md)**: Profile-driven optimization with Go pprof, frontend Lighthouse, and bundle analysis tooling.
406
+ * **[Refactoring Patterns](.agents/skills/refactoring-patterns/SKILL.md)**: Code smell taxonomy, safe transformation techniques, and metrics tracking.
407
+ * **[Research Methodology](.agents/skills/research-methodology/SKILL.md)**: Structured research protocol for investigating technologies and patterns.
408
+ * **[Omni](.agents/skills/omni/SKILL.md)**: Token-efficient communication protocol — opt-in for concise output or agent-to-agent messaging.
409
+
410
+ #### 🎨 Design & UI Skills
411
+ * **[Frontend Design](.agents/skills/frontend-design/SKILL.md)**: Guidelines for creating visually appealing UIs, based on [Anthropic Frontend-Design Skills](https://github.com/anthropics/skills/tree/main/skills/frontend-design)
412
+ * **[Mobile Design](.agents/skills/mobile-design/SKILL.md)**: Production-grade mobile interfaces for Flutter and React Native.
406
413
 
407
- ### Development Workflows
414
+ #### 🔀 Multi-Agent Orchestration Skills
415
+ * **[Parallel Dispatch Decomposition](.agents/skills/parallel-dispatch-decomposition/SKILL.md)**: MECE task decomposition into scope cards for parallel sub-agent execution.
416
+ * **[Parallel Dispatch DAG](.agents/skills/parallel-dispatch-dag/SKILL.md)**: Directed acyclic graph construction and topological sort for safe dispatch ordering.
417
+ * **[Parallel Dispatch Ownership](.agents/skills/parallel-dispatch-ownership/SKILL.md)**: MECE file boundary enforcement to prevent merge conflicts between parallel agents.
418
+ * **[Parallel Dispatch Merge](.agents/skills/parallel-dispatch-merge/SKILL.md)**: Sequential merge protocol with quality gates for integrating parallel worktree branches.
419
+
420
+ #### 🌐 Language & Framework Idioms (18)
421
+
422
+ Language-specific patterns, tooling, and conventions for ecosystems beyond the core rules:
423
+
424
+ | Skill | Ecosystem |
425
+ |---|---|
426
+ | [Angular](.agents/skills/angular-idioms/SKILL.md) | Angular components, DI, RxJS |
427
+ | [C++](.agents/skills/cpp-idioms/SKILL.md) | Modern C++ (RAII, smart pointers) |
428
+ | [C#](.agents/skills/csharp-idioms/SKILL.md) | .NET, async/await, LINQ |
429
+ | [Django](.agents/skills/django-idioms/SKILL.md) | Django ORM, views, middleware |
430
+ | [.NET](.agents/skills/dotnet-idioms/SKILL.md) | ASP.NET Core, Entity Framework |
431
+ | [Elixir](.agents/skills/elixir-idioms/SKILL.md) | OTP, GenServer, supervision |
432
+ | [Java](.agents/skills/java-idioms/SKILL.md) | Streams, records, Spring patterns |
433
+ | [JavaScript](.agents/skills/javascript-idioms/SKILL.md) | ES2024+, async patterns |
434
+ | [Kotlin](.agents/skills/kotlin-idioms/SKILL.md) | Coroutines, sealed classes |
435
+ | [Laravel](.agents/skills/laravel-idioms/SKILL.md) | Eloquent, middleware, queues |
436
+ | [Next.js](.agents/skills/nextjs-idioms/SKILL.md) | App Router, RSC, ISR |
437
+ | [PHP](.agents/skills/php-idioms/SKILL.md) | PHP 8+, type declarations |
438
+ | [Rails](.agents/skills/rails-idioms/SKILL.md) | ActiveRecord, conventions |
439
+ | [React](.agents/skills/react-idioms/SKILL.md) | Hooks, Suspense, Server Components |
440
+ | [Ruby](.agents/skills/ruby-idioms/SKILL.md) | Blocks, modules, RSpec |
441
+ | [Spring Boot](.agents/skills/spring-boot-idioms/SKILL.md) | Spring DI, JPA, WebFlux |
442
+ | [SQL](.agents/skills/sql-idioms/SKILL.md) | Query optimization, indexes |
443
+ | [Swift](.agents/skills/swift-idioms/SKILL.md) | SwiftUI, Combine, async/await |
444
+
445
+ #### 🏢 Domain Skills
446
+ * **[API Documentation](.agents/skills/api-documentation/SKILL.md)**: OpenAPI 3.1 specs, request/response examples, versioning.
447
+ * **[Browser Automation](.agents/skills/browser-automation/SKILL.md)**: Playwright MCP-first automation for E2E testing and UI review.
448
+ * **[Chaos Testing](.agents/skills/chaos-testing/SKILL.md)**: Controlled failure injection and resilience verification.
449
+ * **[CLI Development](.agents/skills/cli-development/SKILL.md)**: CLI tool design, argument parsing, and distribution.
450
+ * **[Data Engineering](.agents/skills/data-engineering/SKILL.md)**: ETL/ELT patterns, data quality, and orchestration.
451
+ * **[Embedded Systems](.agents/skills/embedded-systems/SKILL.md)**: Real-time patterns, RTOS, and hardware abstraction.
452
+ * **[Incident Response](.agents/skills/incident-response/SKILL.md)**: Severity classification, triage, diagnosis, and postmortem.
453
+ * **[ML Engineering](.agents/skills/ml-engineering/SKILL.md)**: ML pipelines, feature engineering, and MLOps.
454
+ * **[Payment Integration](.agents/skills/payment-integration/SKILL.md)**: PCI DSS compliance, tokenization, and webhook reliability.
455
+ * **[Supply Chain Security](.agents/skills/supply-chain-security/SKILL.md)**: SBOM generation, CVE scanning, and license compliance.
456
+
457
+ ### Agent Personas (15)
458
+
459
+ Agent personas are specialized sub-agents designed for multi-agent orchestration. Each agent has an exclusive domain, clear boundaries, and never crosses into another agent's territory — enforcing MECE at the architecture level.
460
+
461
+ #### Layers
462
+
463
+ | Layer | Agents | Purpose |
464
+ |---|---|---|
465
+ | **Research** | `scout` | Codebase exploration, pattern discovery, technology research |
466
+ | **Design** | `architect` + optional `ux-reviewer`, `database-expert`, `security-engineer` | System design, ADRs, API contracts |
467
+ | **Build** | `backend-engineer`, `frontend-engineer`, `mobile-engineer`, `database-expert`, `devops-engineer`, `technical-writer`, `test-automation-engineer`, `performance-engineer`, `refactoring-specialist` | Implementation with isolated worktrees |
468
+ | **Review** | `qa-analyst`, `security-engineer`, `ux-reviewer`, `incident-responder` | Quality gates, security audits, UX review |
469
+
470
+ See the [workflow-team](.agents/workflows/workflow-team.md) workflow for the full dispatch protocol, including parallel dispatch with MECE file ownership and DAG-based execution ordering.
471
+
472
+ ### Development Workflows (12)
408
473
 
409
474
  The setup includes opinionated, end-to-end workflows that chain rules and skills into structured development processes.
410
475
 
411
- #### 🏭 Feature Workflow (`/orchestrator`)
476
+ #### 🏭 Feature Workflow — Single Agent (`/workflow-solo`)
412
477
 
413
- The primary workflow for building features. Phases execute sequentially — **no skipping**.
478
+ The primary workflow for a single agent executing all phases sequentially — **no skipping**.
414
479
 
415
480
  ```
416
481
  Research → Implement (TDD) → Integrate → E2E (conditional) → Verify → Ship
417
482
  ```
418
483
 
419
- | Phase | Workflow | Purpose |
420
- | ------------ | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
421
- | 1. Research | [`/1-research`](.agents/workflows/1-research.md) | Understand context, search docs, create ADRs, uses [Qurio](https://github.com/irahardianto/qurio) default to web search |
422
- | 2. Implement | [`/2-implement`](.agents/workflows/2-implement.md) | TDD cycle: Red → Green → Refactor |
423
- | 3. Integrate | [`/3-integrate`](.agents/workflows/3-integrate.md) | Integration tests with Testcontainers |
424
- | 3.5. E2E | [`/e2e-test`](.agents/workflows/e2e-test.md) | End-to-end validation with Playwright |
425
- | 4. Verify | [`/4-verify`](.agents/workflows/4-verify.md) | Full lint, test, and build validation |
426
- | 5. Ship | [`/5-commit`](.agents/workflows/5-commit.md) | Git commit with conventional format |
484
+ | Phase | Phase File | Purpose |
485
+ | ------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
486
+ | 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 |
487
+ | 2. Implement | [`phase-implement`](.agents/workflows/phase-implement.md) | TDD cycle: Red → Green → Refactor |
488
+ | 3. Integrate | [`phase-integrate`](.agents/workflows/phase-integrate.md) | Integration tests with Testcontainers |
489
+ | 3.5. E2E | [`phase-e2e`](.agents/workflows/phase-e2e.md) | End-to-end validation with Playwright |
490
+ | 4. Verify | [`phase-verify`](.agents/workflows/phase-verify.md) | Full lint, test, and build validation |
491
+ | 5. Ship | [`phase-commit`](.agents/workflows/phase-commit.md) | Git commit with conventional format |
492
+
493
+ #### 🤖 Multi-Agent Orchestration (`/workflow-team`)
494
+
495
+ The pipeline manager workflow for dispatching specialized sub-agents across layers. Supports parallel execution via git worktrees with MECE file ownership.
496
+
497
+ ```
498
+ SCOUT → DESIGN → PRE-MORTEM → BUILD (parallel) → REVIEW (parallel) → REMEDIATE → VERIFY
499
+ ```
500
+
501
+ Includes 12 workflow templates (A-L) for common scenarios: full features, bug fixes, audits, mobile features, security hardening, infrastructure, documentation sprints, incident response, and technical debt.
427
502
 
428
503
  #### 🔧 Specialized Workflows
429
504
 
430
505
  | Workflow | When to Use |
431
506
  | ----------------------------------------------- | ---------------------------------------------------- |
432
- | [`/quick-fix`](.agents/workflows/quick-fix.md) | Bug fixes with known root cause (<50 lines) |
507
+ | [`/bugfix`](.agents/workflows/bugfix.md) | Bug fixes — from hotfixes to complex debugging sessions |
433
508
  | [`/refactor`](.agents/workflows/refactor.md) | Safely restructure code while preserving behavior |
434
509
  | [`/audit`](.agents/workflows/audit.md) | Code review and quality inspection (no new features) |
435
510
  | [`/perf-optimize`](.agents/workflows/perf-optimize.md) | Profile-driven performance optimization |
@@ -439,41 +514,50 @@ Research → Implement (TDD) → Integrate → E2E (conditional) → Verify →
439
514
 
440
515
  ```
441
516
  .agents/
517
+ ├── agents/ # 15 agent personas (multi-agent orchestration)
518
+ │ ├── architect.md
519
+ │ ├── backend-engineer.md
520
+ │ ├── frontend-engineer.md
521
+ │ ├── scout.md
522
+ │ ├── qa-analyst.md
523
+ │ └── ... # 10 more specialized agents
442
524
  ├── rules/ # 42 rules (mandates + principles + language idioms)
443
525
  │ ├── rugged-software-constitution.md
444
526
  │ ├── security-mandate.md
445
527
  │ ├── rule-priority.md
446
528
  │ └── ...
447
- ├── skills/ # 8 specialized skills
448
- │ ├── debugging-protocol/
529
+ ├── skills/ # 43 specialized skills
530
+ │ ├── debugging-protocol/ # Core engineering
449
531
  │ ├── frontend-design/
450
- │ ├── mobile-design/
451
- │ ├── sequential-thinking/
452
532
  │ ├── code-review/
453
- │ ├── guardrails/
454
- │ ├── adr/
455
- │ └── perf-optimization/
456
- └── workflows/ # 11 development workflows
457
- ├── orchestrator.md
458
- ├── 1-research.md
459
- ├── 2-implement.md
460
- ├── 3-integrate.md
461
- ├── 4-verify.md
462
- ├── 5-commit.md
463
- ├── quick-fix.md
464
- ├── refactor.md
465
- ├── audit.md
466
- ├── perf-optimize.md
467
- └── e2e-test.md
533
+ │ ├── parallel-dispatch-*/ # Multi-agent orchestration (4 skills)
534
+ │ ├── java-idioms/ # Language & framework idioms (22 skills)
535
+ │ ├── react-idioms/
536
+ │ ├── incident-response/ # Domain skills
537
+ │ └── ...
538
+ └── workflows/ # 12 development workflows
539
+ ├── workflow-solo.md # Composite: single-agent feature workflow
540
+ ├── workflow-team.md # Composite: multi-agent pipeline manager
541
+ ├── phase-research.md # Phase: understand context
542
+ ├── phase-implement.md # Phase: TDD cycle
543
+ ├── phase-integrate.md # Phase: integration tests
544
+ ├── phase-verify.md # Phase: full validation
545
+ ├── phase-commit.md # Phase: git commit
546
+ ├── phase-e2e.md # Phase: E2E testing
547
+ ├── bugfix.md # Standalone: bug fixes
548
+ ├── refactor.md # Standalone: code restructuring
549
+ ├── audit.md # Standalone: code review
550
+ └── perf-optimize.md # Standalone: performance tuning
468
551
  ```
469
552
 
470
553
  <!-- ROADMAP -->
471
554
  ## Roadmap
472
555
 
473
- - [x] Include more specialized skills to aid development process (8 skills shipped).
474
- - [x] Add development workflows for structured feature delivery (11 workflows shipped).
475
- - [x] Add language-specific idiom and pattern rules (Go, TypeScript, Vue, Flutter, Rust, Python).
556
+ - [x] Include more specialized skills to aid development process (43 skills shipped).
557
+ - [x] Add development workflows for structured feature delivery (12 workflows shipped).
558
+ - [x] Add language-specific idiom and pattern rules (Go, TypeScript, Vue, Flutter, Rust, Python + 22 community language skills).
476
559
  - [x] Create a CLI tool for easier installation (`npx awesome-agv`).
560
+ - [x] Add multi-agent orchestration with 15 specialized agent personas and parallel dispatch.
477
561
  - [ ] Add automated validation scripts to check if an agent is following the constitution.
478
562
  - [x] Publish comprehensive documentation site (GitHub Pages).
479
563
 
@@ -503,7 +587,7 @@ This setup supports different project structures:
503
587
  | **Microservices** | Adapt `project-structure.md` per service, add service mesh rules |
504
588
  | **Mobile (Flutter/RN)** | Adapt frontend rules, add mobile-specific accessibility/testing |
505
589
 
506
- **To adapt:** Edit `project-structure.md`, the relevant idiom file, and `4-verify.md` to match your project layout.
590
+ **To adapt:** Edit `project-structure.md`, the relevant idiom file, and `phase-verify.md` to match your project layout.
507
591
 
508
592
  <!-- CONTRIBUTING -->
509
593
  ## Contributing
package/bin/awesome-agv.js CHANGED
@@ -92,8 +92,9 @@ ${color.bold}EXAMPLES${color.reset}
92
92
 
93
93
  ${color.bold}WHAT GETS INSTALLED${color.reset}
94
94
  ${icons.book} 42 Rules — Security, architecture, language idioms, DevOps standards
95
- ${icons.tool} 7 Skills — Debugging, design, code review, and more
96
- ${icons.cycle} 10 Workflows — End-to-end development processes
95
+ ${icons.tool} 43 Skills — Debugging, design, code review, language idioms, and more
96
+ ${icons.cycle} 12 Workflows — End-to-end development processes
97
+ 🤖 15 Agents — Specialized personas for multi-agent orchestration
97
98
 
98
99
  ${color.dim}https://github.com/${REPO_OWNER}/${REPO_NAME}${color.reset}
99
100
  `);
@@ -284,6 +285,7 @@ function printSuccess(targetDir) {
284
285
  const rulesDir = path.join(agentDir, 'rules');
285
286
  const skillsDir = path.join(agentDir, 'skills');
286
287
  const workflowsDir = path.join(agentDir, 'workflows');
288
+ const agentsDir = path.join(agentDir, 'agents');
287
289
 
288
290
  const rulesCount = fs.existsSync(rulesDir)
289
291
  ? fs.readdirSync(rulesDir).filter((f) => f.endsWith('.md')).length
@@ -294,6 +296,9 @@ function printSuccess(targetDir) {
294
296
  const workflowsCount = fs.existsSync(workflowsDir)
295
297
  ? fs.readdirSync(workflowsDir).filter((f) => f.endsWith('.md')).length
296
298
  : 0;
299
+ const agentsCount = fs.existsSync(agentsDir)
300
+ ? fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md')).length
301
+ : 0;
297
302
  const totalFiles = countFiles(agentDir);
298
303
 
299
304
  console.log(`
@@ -302,16 +307,18 @@ ${color.green}${color.bold} Installation complete! ${icons.rocket}${color.reset
302
307
  ${icons.check} ${color.bold}${totalFiles} files${color.reset} installed to ${color.cyan}${path.relative(process.cwd(), agentDir) || AGENT_DIR}/${color.reset}
303
308
 
304
309
  ${icons.book} ${color.bold}${rulesCount}${color.reset} Rules ${color.dim}Security, architecture, testing standards${color.reset}
305
- ${icons.tool} ${color.bold}${skillsCount}${color.reset} Skills ${color.dim}Debugging, design, code review${color.reset}
310
+ ${icons.tool} ${color.bold}${skillsCount}${color.reset} Skills ${color.dim}Debugging, design, code review, language idioms${color.reset}
306
311
  ${icons.cycle} ${color.bold}${workflowsCount}${color.reset} Workflows ${color.dim}End-to-end dev processes${color.reset}
312
+ 🤖 ${color.bold}${agentsCount}${color.reset} Agents ${color.dim}Specialized multi-agent personas${color.reset}
307
313
 
308
314
  ${icons.arrow} ${color.dim}Your AI agent will automatically pick up the${color.reset}
309
315
  ${color.dim}${AGENT_DIR}/ directory. No additional configuration needed.${color.reset}
310
316
 
311
317
  💡 ${color.bold}Quick start${color.reset} — open a chat with your agent and try:
312
- ${color.cyan}/orchestrator${color.reset} ${color.dim}Build a feature end-to-end${color.reset}
318
+ ${color.cyan}/workflow-solo${color.reset} ${color.dim}Build a feature end-to-end (single agent)${color.reset}
319
+ ${color.cyan}/workflow-team${color.reset} ${color.dim}Build with multi-agent orchestration${color.reset}
313
320
  ${color.cyan}/audit${color.reset} ${color.dim}Review code quality${color.reset}
314
- ${color.cyan}/quick-fix${color.reset} ${color.dim}Fix a bug fast${color.reset}
321
+ ${color.cyan}/bugfix${color.reset} ${color.dim}Fix a bug fast${color.reset}
315
322
  ${color.dim}Rules and skills are modular — use with or without workflows.${color.reset}
316
323
 
317
324
  ${icons.shield} ${color.dim}Learn more: ${color.cyan}https://github.com/${REPO_OWNER}/${REPO_NAME}${color.reset}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "awesome-agv",
3
- "version": "1.2.2",
3
+ "version": "2.0.0",
4
4
  "description": "1-click installer for Awesome AGV — a rugged, high-quality configuration suite for AI Agents.",
5
5
  "bin": {
6
6
  "awesome-agv": "./bin/awesome-agv.js"