Light Factory

A Claude Code plugin providing skills for agentic engineering patterns and practices.

Getting Started

Install

/plugin marketplace add 8thlight/lightfactory
/plugin install lightfactory@praxis
/plugin install lightfactory@harness

After installation, skills are available as praxis:skill-name, harness:skill-name and activate automatically when relevant to your task.

Install from Local Clone

git clone https://github.com/8thlight/lightfactory

/plugin marketplace add /path/to/lightfactory
/plugin install lightfactory@praxis
/plugin install lightfactory@harness

Update

/plugin marketplace update lightfactory@praxis
/plugin marketplace update lightfactory@harness

Available Skills

Praxis Plugin: used for agentic engineering flow

Skill	Command	Description
tdd	/tdd	Boundary-focused TDD workflow enforcing L3/L4 altitude testing and property-based tests
research	/research	Spawns parallel subagents to explore a codebase and produce a compact research artifact
plan-tasks	/plan-tasks	Consumes research artifact and produces a compact implementation plan with L3/L4 test specs
implement	/implement	Executes an implementation plan phase by phase with strict test-first discipline
refactor	/refactor	Refactoring process with test safety and incremental commits
reflect	/reflect	Post-session reflection that mines git history and artifacts to produce improvement proposals

RPI Methodology (Research → Plan → Implement)

The light factory praxis plugin's core workflow for non-trivial features:

1. Research (/research) — Explore the codebase with parallel subagents, output a compact research artifact
2. Plan (/plan-tasks) — Consume the research artifact, produce a compact implementation plan with test specs
3. Implement (/implement) — Execute the plan phase by phase with strict RED → GREEN → VALIDATE discipline

Harness Plugin: used for harness engineering flow

Skill	Command	Description
diagram	/diagram	Creates architecture diagrams (C4 structural, dynamic flows, data flow) with subtype dispatch
scaffold	/scaffold	Scaffolds DDD projects from Gherkin feature files with language subtype dispatch
hexagonal-architecture	/hexagonal-architecture	Applies hexagonal (ports & adapters) architecture with domain-first design
adr	/adr	Guides writing minimal Architecture Decision Records

Testing

Skills are validated by a three-layer pipeline. See tests/README.md for full methodology.

Layer 1 — Deterministic (local): Validates skill structure, frontmatter, triggers, and scenario schemas. No API calls.

bash tests/local/validate-skills.sh

Layer 2 — Promptfoo evals: Functional and behavioral evaluation using real Claude API calls. See tests/evals/README.md for setup and cost.

cd tests/evals && promptfoo eval

Layer 3 — Human review: Manual review for subjective quality and calibrating LLM-judge rubrics.

Contributing

See AGENTS.md for skill authoring guidelines, testing workflows, and the pre-ship checklist.

See docs/architecture.md for project structure and key concepts.