Skip to content

fheinent/team-os

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Org OS — Starter

A blank scaffold to start your team's shared workflow layer. Companion to the Claude Code for Orgs workshop.

What this is

The same folder structure as the Faculty Products Org OS example — but empty. Drop your team's content into the right folders and you've got a working Org OS.

.
├── CLAUDE.md                  # the lean root — fill in your team
├── customers/                 # CONTEXT: customer calls, summaries, playbooks
├── analytics/                 # CONTEXT: metric definitions, queries, playbooks
├── templates/                 # CONTEXT: PRD, status update, RFC structures
└── .claude/
    ├── skills/                # ACTIONS: shared workflows (slash commands)
    └── rules/                 # BEHAVIOR: file naming, prioritization, etc.

How to use it

Step 1 — Clone and rename

gh repo create my-org-os --template carlvellotti/org-os-starter --private
cd my-org-os

Step 2 — Fill in CLAUDE.md

Open CLAUDE.md. Replace the placeholders with your team:

  • Team roster (names, Slack handles, GitHub handles)
  • Slack channels you actually use
  • Folder pointers (these probably don't change)

Keep it under one page. The rule is lean root, nested files for everything.

Step 3 — Capture your first thing

Pick one piece of context that's currently in your head or in old Slack threads. Write it down in the appropriate folder:

  • A customer? → customers/account-summaries/
  • A metric definition? → analytics/metrics/
  • A playbook? → wherever it fits

Just one. The OS grows from real friction, not pre-planning.

Step 4 — Build your first skill

Pick the most-duplicated task on your team. Write it as a skill in .claude/skills/. Use the example skills in the FP repo as a reference.

Step 5 — Get one teammate using it

This is the whole game. See the /orgos page for the full rollout playbook.

What's in here

  • CLAUDE.md — root template with placeholder team info
  • customers/CLAUDE.md — folder navigation map template
  • analytics/CLAUDE.md — folder navigation map template
  • templates/ — empty
  • .claude/skills/ — empty
  • .claude/rules/ — empty
  • CONTRIBUTING.md — example contribution guide for your team to adapt

Where to learn more


Built by Carl Vellotti.

About

Blank Org OS scaffold — companion to fullstackpm.com/orgos

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors