By v4-company
Core skills library for the V4-Company Team: TDD, debugging, collaboration patterns, and proven techniques. Features parallel 7-reviewer code review system, systematic debugging, and workflow orchestration. 21 essential skills for software engineering excellence.
npx claudepluginhub v4-company/marsai --plugin marsai-defaultGenerate an Ops Update Guide from git diff between two refs
Generate beautiful, self-contained HTML pages that visually explain systems, code, and data
Create isolated git worktree with interactive setup
Create detailed implementation plan with bite-sized tasks
Interactive design refinement using Socratic method
Run comprehensive parallel code review with all 7 specialized reviewers
Organize and create atomic git commits with intelligent change grouping
Create a handoff document capturing current session state, with automatic context-clear and resume via Plan Mode
Generate Mermaid diagrams and open them in mermaid.live
Execute plan in batches with review checkpoints
Autonomous two-phase codebase exploration with adaptive agents
Proactive requirements gathering through structured user interview
Run lint checks and dispatch parallel agents to fix all issues
Transform a markdown file into a standalone, styled HTML page
Correctness Review: reviews domain correctness, business rules, edge cases, and requirements. Uses mental execution to trace code paths and analyzes full file context, not just changes. Runs in parallel with marsai:code-reviewer, marsai:security-reviewer, marsai:test-reviewer, marsai:nil-safety-reviewer, marsai:consequences-reviewer, and marsai:dead-code-reviewer for fast feedback.
Foundation Review: Reviews code quality, architecture, design patterns, algorithmic flow, and maintainability. Runs in parallel with marsai:business-logic-reviewer, marsai:security-reviewer, marsai:test-reviewer, marsai:nil-safety-reviewer, marsai:consequences-reviewer, and marsai:dead-code-reviewer for fast feedback.
Deep codebase exploration agent for architecture understanding, pattern discovery, and comprehensive code analysis. Deep codebase exploration agent for thorough analysis.
Ripple Effect Review: traces how code changes propagate through the codebase beyond the changed files. Walks caller chains, consumer contracts, shared state, and implicit dependencies to find breakage invisible in isolated review. Runs in parallel with marsai:code-reviewer, marsai:business-logic-reviewer, marsai:security-reviewer, marsai:test-reviewer, marsai:nil-safety-reviewer, and marsai:dead-code-reviewer for fast feedback.
Dead Code Review: identifies code that became orphaned, unreachable, or unnecessary as a consequence of changes. Walks the dependency graph outward from the diff to find abandoned helpers, unused types, orphaned modules, and zombie test infrastructure across three concentric rings: target files, first-derivative dependents, and transitive ripple effect. Runs in parallel with marsai:code-reviewer, marsai:business-logic-reviewer, marsai:security-reviewer, marsai:test-reviewer, marsai:nil-safety-reviewer, and marsai:consequences-reviewer for fast feedback.
Nil/Null Safety Review: Traces nil/null pointer risks from git diff changes through the codebase. Identifies missing guards, unsafe dereferences, panic paths, and API response consistency in Go and TypeScript. Runs in parallel with marsai:code-reviewer, marsai:business-logic-reviewer, marsai:security-reviewer, marsai:test-reviewer, marsai:consequences-reviewer, and marsai:dead-code-reviewer.
Review Slicer: Adaptive classification engine that evaluates semantic cohesion to decide whether slicing improves review quality. Sits between pre-analysis and reviewer dispatch. Classification-only — does NOT read source code.
Safety Review: Reviews vulnerabilities, authentication, input validation, and OWASP risks. Runs in parallel with marsai:code-reviewer, marsai:business-logic-reviewer, marsai:test-reviewer, marsai:nil-safety-reviewer, marsai:consequences-reviewer, and marsai:dead-code-reviewer for fast feedback.
Test Quality Review: Reviews test coverage, edge cases, test independence, assertion quality, and test anti-patterns across unit, integration, and E2E tests. Runs in parallel with marsai:code-reviewer, marsai:business-logic-reviewer, marsai:security-reviewer, marsai:nil-safety-reviewer, marsai:consequences-reviewer, and marsai:dead-code-reviewer for fast feedback.
Implementation Planning: Creates comprehensive plans for engineers with zero codebase context. Plans are executable by developers unfamiliar with the codebase, with bite-sized tasks (2-5 min each) and code review checkpoints.
Socratic design refinement - transforms rough ideas into validated designs through structured questioning, alternative exploration, and incremental validation.
Generate Mermaid diagrams from context and open them in mermaid.live in the browser. Use when the user asks for a diagram, visualization, flowchart, sequence diagram, ER diagram, or any visual representation of code, architecture, or processes. Produces lightweight, shareable mermaid.live URLs that open in the browser for interactive editing.
Controlled plan execution with human review checkpoints - loads plan, executes in batches, pauses for feedback. Supports one-go (autonomous) or batch modes.
Autonomous two-phase codebase exploration - first discovers natural perspectives (layers, components, boundaries), then dispatches adaptive deep-dive explorers based on what was discovered. Synthesizes findings into actionable insights.
Send tasks to Gandalf (AI team member) via webhook and get responses back. Publish to Alfarrábio, send Slack notifications, ask for business context, and more.
Smart commit organization with atomic grouping, conventional commits, and trailer management
Proactive requirements gathering - systematically interviews the user to uncover ambiguities, preferences, and constraints BEFORE implementation begins.
Parallel lint fixing pattern - runs lint checks, groups issues into independent streams, and dispatches AI agents to fix all issues until the codebase is clean.
Generate Ops Update Guide from Git Diff. Produces internal Operations-facing update/migration guides based on git diff analysis. Supports STRICT_NO_TOUCH (default) and TEMP_CLONE_FOR_FRESH_REFS modes. Includes tag auto-detection and commit log analysis.
Create handoff documents capturing session state for seamless context-clear and resume
Four-phase debugging framework - root cause investigation, pattern analysis, hypothesis testing, implementation. Ensures understanding before attempting fixes.
RED-GREEN-REFACTOR implementation methodology - write failing test first, minimal implementation to pass, then refactor. Ensures tests verify behavior.
Agent testing methodology - run agents with test inputs, observe outputs, iterate until outputs are accurate and well-structured.
Test quality guard - prevents testing mock behavior, production pollution with test-only methods, and mocking without understanding dependencies.
Skill testing methodology - run scenarios without skill (RED), observe failures, write skill (GREEN), close loopholes (REFACTOR).
Isolated workspace creation - creates git worktrees with smart directory selection and safety verification for parallel feature development.
Mandatory orchestrator protocol - establishes ORCHESTRATOR principle (dispatch agents, don't operate directly) and skill discovery workflow for every conversation.
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead.
Creates comprehensive implementation plans with exact file paths, complete code examples, and verification steps for engineers with zero codebase context.
TDD for process documentation - write test cases (pressure scenarios), watch baseline fail, write skill, iterate until bulletproof against rationalization.
A Claude Code plugin that enforces proven engineering practices through automated workflows, specialized agents, and mandatory gates.
git clone https://github.com/V4-Company/marsai.git ~/marsai
cd ~/marsai
./install-symlinks.sh
Restart Claude Code. Skills load automatically.
/write-plan # plan it
/execute-plan # build it step by step
/dev-cycle tasks.md # backend: 8 gates
/dev-cycle-frontend tasks.md # frontend: 9 gates
You can also skip the tasks file and just describe what you want:
/dev-cycle "Add JWT authentication with refresh tokens"
| Command | What it does |
|---|---|
/codereview | Run 7 parallel code reviewers on your changes |
/commit | Smart commit with conventional format |
/dev-refactor | Analyze codebase against standards and fix |
/brainstorm | Refine a rough idea into a design |
/explore-codebase | Deep dive into unfamiliar code |
/worktree | Isolate work in a git worktree |
When you run /dev-cycle, it walks through these gates automatically:
| Gate | What happens |
|---|---|
| 0 | Implementation — writes code using TDD (test first, then code) |
| 0.5 | Delivery verification — checks what was requested was actually built |
| 1 | DevOps — Dockerfile, docker-compose, env vars |
| 2 | SRE — validates logging, tracing, health checks |
| 3 | Unit testing — ensures 85%+ coverage |
| 4 | Integration testing — tests with real containers |
| 5 | Chaos testing — breaks things on purpose to verify graceful degradation |
| 6 | Code review — 7 reviewers in parallel |
| 7 | Validation — final check, asks for your approval |
Each gate dispatches a specialist agent. If a gate finds problems, it fixes them before moving on.
The frontend cycle (/dev-cycle-frontend) replaces gates 4-5 with accessibility, visual testing, E2E, and performance gates.
You don't call these directly — the dev-cycle dispatches them. But you can if needed.
Reviewers (dispatched by /codereview):
| Agent | Focus |
|---|---|
marsai:code-reviewer | Architecture, patterns, quality |
marsai:business-logic-reviewer | Domain correctness, edge cases |
marsai:security-reviewer | Vulnerabilities, OWASP |
marsai:test-reviewer | Test coverage, assertions |
marsai:nil-safety-reviewer | Null pointer risks |
marsai:consequences-reviewer | Ripple effects beyond changed files |
marsai:dead-code-reviewer | Orphaned code detection |
Developers (dispatched by /dev-cycle):
| Agent | Focus |
|---|---|
marsai:backend-engineer-typescript | TypeScript backend |
marsai:frontend-engineer | React/Next.js |
marsai:frontend-bff-engineer-typescript | BFF layer |
marsai:devops-engineer | Docker, infra |
marsai:sre | Observability |
marsai:qa-analyst | Backend testing |
marsai:qa-analyst-frontend | Frontend testing (a11y, visual, E2E, perf) |
marsai:helm-engineer | Helm charts |
marsai:frontend-designer | UI/UX design specs |
marsai:ui-engineer | Design system components |
marsai/
├── default/ # Core plugin (22 skills, 10 agents, 14 commands)
│ ├── skills/ # Skill definitions (markdown + frontmatter)
│ ├── agents/ # Reviewer and planning agents
│ ├── commands/ # Slash command definitions
│ └── hooks/ # Session startup hooks
├── dev-team/ # Developer plugin (26 skills, 11 agents, 8 commands)
│ ├── skills/ # Dev cycle gate skills
│ ├── agents/ # Specialist developer agents
│ ├── commands/ # Dev workflow commands
│ └── docs/standards/ # TypeScript, DevOps, SRE, Helm, Frontend standards
├── CLAUDE.md # Project rules for Claude Code
├── install-symlinks.sh # Links plugins into ~/.claude/
└── install-marsai.sh # One-liner installer
MIT
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Uses power tools
Uses Bash, Write, or Edit tools
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use
Team-oriented workflow plugin with role agents, 27 specialist agents, ECC-inspired commands, layered rules, and hooks skeleton.
AI-supervised issue tracker for coding workflows. Manage tasks, discover work, and maintain context with simple CLI commands.
Context-Driven Development plugin that transforms Claude Code into a project management tool with structured workflow: Context → Spec & Plan → Implement
AI-powered development tools for code review, research, design, and workflow automation.