Claude Code Workspace Template

A structured workspace template for working with Claude Code as a persistent agent assistant across sessions. It is built around a /prime command that loads your context at the start of every session, plus /create-plan and /implement for plan‑first changes.

What's Included

• CLAUDE.md
  Core workspace configuration. Auto‑loaded by Claude Code at session start.

• .claude/commands/
  Slash commands for structured workflows:

  • prime.md – /prime: initialize a session, read context, summarize, confirm readiness.
  • create-plan.md – /create-plan: generate detailed implementation plans before changes.
  • implement.md – /implement: execute a selected plan step‑by‑step and update its status.

• context/
  Personalizable context files you fill in locally:

  • business-info.md – org / business background.
  • personal-info.md – your role and responsibilities.
  • strategy.md – current priorities and success criteria.
  • current-data.md – metrics and current state.

  These are git‑ignored so your private details are never committed.

• plans/
  Stores implementation plans generated by /create-plan.

• outputs/
  Destination for deliverables and work products created in this workspace.

• reference/
  Space for templates, examples, and reusable patterns.

• scripts/
  Automation and helper scripts (you can add your own here).

Skill Creation & Packaging

This template also includes a lightweight skill creation toolchain for authoring and packaging Claude skills.

• SKILL.md
  A comprehensive guide on how to design, structure, and document skills (frontmatter, references, assets, and best practices).

• init_skill.py
  CLI helper to scaffold a new skill directory with a starter SKILL.md and optional scripts/, references/, and assets/ subfolders.

  Example:

  python init_skill.py my-new-skill --path skills/public --resources scripts,references --examples

• quick_validate.py
  Validates a skill folder by checking SKILL.md frontmatter, name/description rules, and basic constraints before packaging.

Example:

python quick_validate.py skills/public/my-new-skill

• package_skill.py Packages a validated skill folder into a distributable .skill file (zip format with a .skill extension).

Examples:

python package_skill.py skills/public/my-new-skill
python package_skill.py skills/public/my-new-skill ./dist

Use this combo to design, test, and bundle reusable skills that can be shared or reused across workspaces.

How to Use This Template

1. Clone the repo

git clone https://github.com/pipodepalma-ops/claude-workspace-template-updated.git
cd claude-workspace-template-updated

1. Fill in your context
   • Edit files in context/ with your real role, org, strategy, and metrics.
   • These files are git‑ignored by default to keep them private.
2. Open in Claude Code or VS Code
   • In Claude Code, point the workspace at this folder.
   • In VS Code, open the folder and use your preferred Claude integration.
3. Start sessions with /prime
   • Run /prime to let Claude read CLAUDE.md and context/, then summarize its understanding and confirm readiness.
4. Use plan‑first changes
   • For structural changes, run /create-plan with a request.
   • Review the generated plan in plans/.
   • Run /implement path/to/plan.md to execute the changes.

Optional: Shell Aliases

See shell-aliases.md for convenience commands:

• cs – launch Claude Code and run /prime with permission prompts.
• cr – launch Claude Code and run /prime with prompts skipped for faster, trusted flows.

License

This project is licensed under the MIT License – see LICENSE for details.