skynex-pi

Multi-agent coding harness for Pi — triage + 17 skills + 11 sub-agents + 7 extensions. Full medium/substantial-path workflow with HITL gates, TDD enforcement, and adversarial review.

What it gives you

When you install skynex-pi in Pi, you get:

• 7 extensions — triage, iron-law, skill-registry, smart-zone, archive, neurox-tool, production-gate, skynex-installer
• 17 skills — discover, plan, build, validate, propose, specify, prd, grill-me, tdd-discipline, verification-before-completion, adversarial-review, security, branch-pr, chained-pr, work-unit-commits, comment-writer, cognitive-doc-design, research
• 11 sub-agents — scout, tech-planner, coder, verifier, test-reviewer, security, skill-validator, product-planner, architect, archivist

Triage classifies your prompt into one of 4 paths and injects the right workflow:

Path	When	Workflow
conversational	Greetings, questions	No workflow, just chat
small	Single-file edits, typos	Direct edit
medium	New features, refactors	discover → plan → build → validate
substantial	Auth, payments, migrations	discover → propose → specify → plan → build → validate

Quick install

# 1. Install skynex-pi globally
pi install npm:skynex-pi

# 2. Install companion Pi packages
pi install npm:pi-sub-agent
pi install npm:@juicesharp/rpiv-todo
pi install npm:pi-web-access
pi install npm:pi-mcp-adapter

# 3. Restart Pi or start a new session
pi

On first Pi session, skynex-installer automatically copies sub-agents to ~/.pi/agent/agents/ so they're available globally.

Required companion packages

skynex-pi depends on these Pi packages for full functionality:

Package	What it adds	Why required
pi-sub-agent	subagent tool for parallel/chained agent invocation	All workflows use sub-agents
@juicesharp/rpiv-todo	todo tool + live overlay	Used by build skill to track slice progress
pi-web-access	web_search, fetch_content	Used by /skill:research and scout
pi-mcp-adapter	MCP server support (Atlassian, Slack, Figma, Neurox, etc.)	Optional but recommended

These are NOT bundled to avoid version conflicts. Install them separately.

MCPs (optional)

For MCP servers (Atlassian, Slack, Figma, Neurox memory, Cloudflare, etc.), create ~/.config/mcp/mcp.json or ~/.pi/agent/mcp.json:

{
  "settings": {
    "toolPrefix": "short",
    "idleTimeout": 10
  },
  "mcpServers": {
    "neurox": {
      "command": "neurox",
      "args": ["mcp"],
      "lifecycle": "keep-alive"
    }
  }
}

See pi-mcp-adapter docs for full configuration options.

Environment variables

Variable	Purpose	Default
SKYNEX_HITL	HITL gate mode: single (default), strict, or none	single
SKYNEX_AGENT_HOME	Override agent install location	~/.pi/agent

For substantial-path workflows, defaults are sensible. Override only if needed.

Usage

After install, just use Pi normally. Triage runs automatically on every prompt:

pi
# Type: "agrega isValidEmail con tests TDD"
# Triage → medium → discover → plan → build → validate (autonomous after gates)

# Or:
# Type: "rebuild auth para soportar SAML SSO"
# Triage → substantial → discover → propose → specify → plan → [HITL gate] → build → validate

Slash commands

Command	What it does
/skill:<name>	Manually invoke a skill (discover, plan, build, validate, propose, specify, research, etc.)
/triage:status	Show current session classification
/skynex:install	Re-install/refresh agent files
/skynex:status	Show installation health
/skills:list	List all available skills
/skills:refresh	Reload skill registry
/iron-law:status	Check TDD enforcement status
/archive:run	Manually trigger archivist (end-of-session synthesis)
/mcp	Interactive MCP server panel (requires pi-mcp-adapter)
/todos	Show todo list (requires rpiv-todo)

Customization

Skills

To override a skill in your project, create .pi/skills/<name>/SKILL.md in your project. Project skills take precedence over global ones.

Sub-agents

To override a sub-agent, create .pi/agents/<name>.md in your project with agentScope: "both" or "project" in your subagent invocations.

Triage rules

Configure via .skynex/triage.config.json in your project. See triage docs if it exists.

Status

v0.1.0 — Initial public release. All 3 paths working end-to-end. 307 tests passing.

Contributing

See CONTRIBUTING.md if present, or open an issue on GitHub.

License

MIT