mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

fix: phantom-path sweep — 888 unresolvable references to zero

A directory reorg added a skills/ path segment; hundreds of references never
followed. This sweep repoints every path-like reference in SKILL.md, agents,
commands, orchestration, and templates to verified on-disk targets:

- 30 root commands + 19 root agents: missing skills/ segment inserted
- 7 c-level persona agents: 17 hallucinated reference filenames substituted
  with the real files (e.g. okr_execution.md -> process_frameworks.md)
- 5 research skills: phantom scripts/office/validate.py step replaced with a
  runnable stdlib zip-integrity check
- email agents: skills frontmatter corrected to productivity/email
- orchestration/ORCHESTRATION.md + templates: stale paths fixed;
  agent-template now requires trigger phrasing in descriptions (root cause)
- 76 more files across engineering, c-level-advisor, compliance-os,
  research-ops, ra-qm, marketing, productivity; dual-publish pairs mirrored
- dead refs dropped/replaced where no target ever existed (REGISTRY.md,
  trend_analyzer.py, cursor-microinteractions.md)

New: scripts/check_paths.py linter (CI gate G1) + narrow allowlist for
teaching examples. Verified: 540 files scanned, 0 unresolvable.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF

2026-06-10 14:33:00 +00:00

1.7 KiB

Raw Blame History

Templates - Claude Code Guidance

This guide explains the template system for agents, commands, and standardized workflows.

Template Purpose

Location: templates/

Purpose: Reusable templates for consistent agent development, slash command creation, and workflow automation across all domains.

Available Templates

Agent Templates

Location: templates/agent-template.md

Usage: Starting point for creating new cs-* agents

Contains:

YAML frontmatter structure
Required markdown sections
Workflow documentation format
Integration examples pattern

When to Use: Creating any new agent in agents/ directory

Command Templates and Workflow Templates

Not yet created. There is no command template or workflow template file in templates/ today — when creating slash commands, copy an existing command in commands/ (e.g. commands/cs-backend-review.md for the argument-hint + gate pattern) instead of looking for a template here.

Template Usage Pattern

# 1. Copy template
cp templates/agent-template.md agents/domain/cs-new-agent.md

# 2. Customize for your agent
vim agents/domain/cs-new-agent.md

# 3. Follow template structure exactly

# 4. Test relative paths and integrations

# 5. Commit with conventional commit
git commit -m "feat(agents): implement cs-new-agent from template"

Agent Development: ../agents/CLAUDE.md - Comprehensive agent creation guide
Standards: ../standards/CLAUDE.md - Quality and consistency standards
Main Documentation: ../CLAUDE.md - Repository overview

Last Updated: November 5, 2025 Purpose: Consistent templates for rapid agent and workflow development

1.7 KiB Raw Blame History