Files
Daniel Avila 7f890b1b3b feat: add Loops component type with referenced components (#643)
* feat: add Loops component type with referenced components

Introduce "loops" as a new first-class component type — autonomous
agentic workflows (goal + interval + stop condition) inspired by Loop
Engineering and the Forward Future Loop Library. A loop references other
components (agents, skills, hooks, commands) and the dashboard renders
those references as clickable cards on the loop detail page.

- Add 10 starter loops under cli-tool/components/loops/
  (engineering, evaluation, operations)
- Catalog generator: scan loops + write per-component content files
- Dashboard: new type in icons/types/data, /loops page, and a
  "Referenced Components" section on the loop detail page
- CLI: --loop flag installs the loop to .claude/loops/ and
  auto-installs its referenced components
- Docs: CLAUDE.md and cli-tool rule updated

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T9ynMiCHt8JwdMd8KjCkES

* feat: add 8 more loops (goal/loop/schedule patterns)

Expand the loops catalog to 18, drawing ideas from community "Loop
Engineering" patterns. Adds loops across the three trigger verbs
(/goal, /loop, /schedule) and emphasizes the verifier-in-the-loop and
budget / anti-spin guardrails:

- engineering/five-minute-maintainer-loop
- engineering/build-test-fix-loop
- engineering/anti-spin-build-loop
- engineering/completion-contract-loop (goal)
- engineering/goal-refiner-loop (goal)
- engineering/adversarial-review-loop (cross-model)
- operations/overnight-pr-routine-loop (schedule)
- evaluation/human-approval-loop (human-in-the-loop)

All referenced components verified to exist; catalog regenerated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T9ynMiCHt8JwdMd8KjCkES

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-21 20:19:16 -04:00

1.3 KiB

paths
paths
cli-tool/**
src/**

CLI Tool — Component System

This is the npm package claude-code-templates. A Node.js CLI for installing Claude Code components.

Architecture

  • Entry point: src/index.js
  • Components live in cli-tool/components/{type}/{category}/{name}.md
  • Types: agents, commands, mcps, hooks, settings, skills, loops, templates
  • Loops live at cli-tool/components/loops/{category}/{name}.md (markdown + frontmatter), install to .claude/loops/, and auto-install the components listed in their components: frontmatter field
  • Catalog generated by python scripts/generate_components_json.py

Component Files

  • Format: Markdown with YAML frontmatter
  • Names: kebab-case only (e.g., react-performance-expert.md)
  • No hardcoded secrets, API keys, or absolute paths
  • Include clear description, usage examples, and tags
  • Always validate with the component-reviewer agent before committing

After Adding/Modifying Components

  1. Run python scripts/generate_components_json.py to regenerate catalog
  2. Copy docs/components.json to dashboard/public/components.json
  3. Deploy dashboard

Testing

npm test          # Run all tests
npm run test:watch

Publishing

Always check npm view claude-code-templates version before publishing to avoid version conflicts.