About

Imported from rysweet/amplihack (.claude/skills/amplihack-expert/SKILL.md). Install upstream with npx skills add rysweet/amplihack --skill amplihack-expert. Copyright stays with the author.

amplihack Expert Knowledge

Name: amplihack-expert
Author: rysweet

What is amplihack?

Engineering system for coding CLIs (Claude, Copilot, Amplifier): 5 mechanisms, 23-step workflow, 30+ agents, 80+ skills. Core entry point: /dev <task> — unified task orchestrator with auto-classification, parallel workstream detection, and goal-seeking execution loop.

Quick Reference

Top Commands

Command	Purpose	Use When
/dev	Orchestrate	Any non-trivial task
/analyze	Review	Check compliance
/fix	Fix errors	Common error patterns
/amplihack:ddd:*	Doc-driven dev	10+ file features
/multitask	Parallel tasks	Sprint/batch work

Top Agents

Agent	Role
architect	Design
builder	Code
reviewer	Quality
tester	Tests

Workflows

Name	Steps
DEFAULT_WORKFLOW	23
INVESTIGATION	6
FIX	3

Navigation Guide

Quick: SKILL.md | Architecture: reference.md | How-To: examples.md | Deep: all

Core Concepts

5 Mechanisms: Workflow (process), Command (entry), Skill (auto), Agent (delegate), Hook (runtime)

Composition: Commands → Workflows → Agents → Skills

Execution: /dev orchestrates — classifies task, detects parallel workstreams, executes via smart-orchestrator recipe, goal-seeking loop (3 rounds max)

Entry point: /dev <task> → dev-orchestrator skill → smart-orchestrator recipe → default-workflow recipe

dev-orchestrator Architecture

Entry point: /dev <task> or any non-trivial prompt

Routing:

Q&A → amplihack:core:analyzer responds directly
Operations → bash (simple) or amplihack:core:builder (complex)
Development/Investigation → smart-orchestrator recipe (full orchestration)

Execution flow:

Classify task (architect agent → JSON decomposition)
Detect workstreams (1 = single session, 2-5 = parallel via multitask)
Register session in tree (depth/capacity enforcement)
Execute rounds (up to 3, goal-seeking reflection loop)
Summarize results with PR links and GOAL_STATUS

Session tree: Prevents infinite recursion

AMPLIHACK_MAX_DEPTH=3 (default) — increase to 5 for deep orchestration
AMPLIHACK_MAX_SESSIONS=10 (default) — max concurrent sessions per tree

Status signals:

GOAL_STATUS: ACHIEVED — all criteria met
GOAL_STATUS: PARTIAL -- [gaps] — another round will run
GOAL_STATUS: NOT_ACHIEVED -- [reason] — final failure status

Related Docs

reference.md: Architecture (5 mechanisms, 5 layers, hooks)
examples.md: Scenarios (5+ real examples)
@~/.amplihack/.claude/context/PHILOSOPHY.md: Core principles
@~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md: 23 steps
@~/.amplihack/.claude/agents/amplihack/: All agents
@~/.amplihack/.claude/commands/amplihack/: All commands
@~/.amplihack/.claude/tools/amplihack/hooks/: Hook system
amplifier-bundle/recipes/smart-orchestrator.yaml: Core orchestration recipe
amplifier-bundle/tools/session_tree.py: Recursion guard (depth limits)
amplifier-bundle/tools/orch_helper.py: JSON extraction helper

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/rysweet-amplihack-amplihack-expert/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

rysweet-amplihack-amplihack-expert.ocm.jsonjson

{
  "ocm": "1",
  "id": "rysweet-amplihack-amplihack-expert",
  "kind": "skill",
  "name": "amplihack-expert",
  "description": "Comprehensive knowledge of amplihack framework architecture, patterns, and usage",
  "publisher": "rysweet",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "amplihack",
      "framework",
      "architecture",
      "workflows",
      "agents",
      "commands",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Comprehensive knowledge of amplihack framework architecture, patterns, and usage"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/rysweet/amplihack",
      "path": ".claude/skills/amplihack-expert/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/rysweet/amplihack/blob/HEAD/.claude/skills/amplihack-expert/SKILL.md",
      "key": "rysweet/amplihack/.claude/skills/amplihack-expert/SKILL.md"
    }
  },
  "instructions": "# amplihack Expert Knowledge\n\n## What is amplihack?\n\nEngineering system for coding CLIs (Claude, Copilot, Amplifier): 5 mechanisms, 23-step workflow, 30+ agents, 80+ skills. Core entry point: `/dev <task>` — unified task orchestrator with auto-classification, parallel workstream detection, and goal-seeking execution loop.\n\n## Quick Reference\n\n### Top Commands\n\n| Command           | Purpose        | Use When              |\n| ----------------- | -------------- | --------------------- |\n| /dev              | Orchestrate    | Any non-trivial task  |\n| /analyze          | Review         | Check com",
  "cost": {
    "context_tokens": 833
  }
}

Fetch it by URL: GET /api/v1/registry/rysweet-amplihack-amplihack-expert/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.