Skip to content

cskwork/claude-code-announcements

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-code-workflow-cheatsheet

Never forget a slash command again. Auto-generated workflow cheatsheets that live inside Claude Code.

License: MIT Claude Code PRs Welcome


The Problem

You installed Superpowers, Everything Claude Code, Oh My Claude Code, or built your own commands — then forgot half of them exist. You end up using the same 3 commands while 40+ sit unused.

The Solution

This skill scans your installed commands and generates a persistent cheatsheet that Claude sees at the start of every session — via the companyAnnouncements field in settings.json.

┌─────────────────────────────────────────────────────────────────────┐
│  What Claude sees every session:                                    │
│                                                                     │
│  [Workflows] Dev: /orchestrate feature "desc" -> /e2e               │
│  [Workflows] Quality: /code-review -> /refactor-clean -> /verify    │
│  [Workflows] Multi: /multi-plan -> /multi-execute | /devfleet       │
│  [Workflows] Learn: /learn -> /learn-eval -> /skill-create          │
│  [OMC] Auto: autopilot: desc | Persist: ralph: desc                 │
│  [Superpowers] Design: /brainstorming -> /writing-plans             │
│  ...                                                                │
│                                                                     │
│  Claude now proactively suggests the RIGHT command for your task.   │
└─────────────────────────────────────────────────────────────────────┘

Before: You type /plan for everything. After: Claude suggests /orchestrate bugfix "login crash" -> /e2e because it knows the full workflow.


Quick Start

Option 1: Claude Code Skill (Recommended)

# Copy the skill into your Claude Code skills directory
cp -r . ~/.claude/skills/company-announcements

Then in Claude Code:

/setup-announcements                       # Auto-detect your installed commands
/setup-announcements --harness superpowers # Superpowers preset
/setup-announcements --harness ecc         # Everything Claude Code preset
/setup-announcements --harness omcc        # Oh My Claude Code preset

Option 2: Manual Install (30 seconds)

Pick a preset and paste it into ~/.claude/settings.json:

Superpowers (obra) - 5 workflow categories
{
  "companyAnnouncements": [
    "[Superpowers] Design: /brainstorming -> /writing-plans\n[Superpowers] Execute: /using-git-worktrees -> (/executing-plans or /subagent-driven-development)\n[Superpowers] Per Task: /test-driven-development -> /requesting-code-review -> /receiving-code-review\n[Superpowers] Finish: /verification-before-completion -> /finishing-a-development-branch\n[Superpowers] Tools: /systematic-debugging (bugs) | /dispatching-parallel-agents (parallel) | /writing-skills (meta)"
  ]
}
Everything Claude Code (ECC) - 7 workflow categories
{
  "companyAnnouncements": [
    "[Workflows] Dev: /orchestrate feature|bugfix \"desc\" -> /e2e | Manual: /plan -> /tdd -> /code-review -> /verify\n[Workflows] Reproduce: /e2e (as-is) -> /orchestrate bugfix -> /e2e (to-be) | Build: /build-fix -> /verify\n[Workflows] Quality: /code-review -> /refactor-clean -> /verify | /quality-gate | /eval define|check|report\n[Workflows] Multi: /multi-plan -> /multi-execute | /devfleet \"task\" | /model-route \"task\" --budget low|med|high\n[Workflows] Docs: /update-docs, /update-codemaps | Ref: /docs \"lib\" | Loop: /loop-start sequential|continuous-pr\n[Workflows] Learn: /learn -> /learn-eval -> /skill-create | Instincts: /instinct-status -> /evolve -> /promote\n[Workflows] Session: /save-session, /resume-session | Meta: /harness-audit, /skill-health, /context-budget"
  ]
}
Oh My Claude Code (OMCC) - 6 workflow categories
{
  "companyAnnouncements": [
    "[OMC] Auto: autopilot: desc | Persist: ralph: desc | Parallel: ulw tasks\n[OMC] Team: /oh-my-claudecode:team 3:executor \"task\" | Plan: ralplan | QA: /oh-my-claudecode:ultraqa\n[OMC] Clarify: deep-interview \"idea\" -> omc-plan --consensus -> autopilot: desc\n[OMC] Investigate: /oh-my-claudecode:trace | Tri-Model: ccg \"query\" | Visual: /oh-my-claudecode:visual-verdict\n[OMC] Cleanup: deslop | Skills: /oh-my-claudecode:skill list | Learn: /oh-my-claudecode:learner\n[OMC] Session: /oh-my-claudecode:psm | Release: /oh-my-claudecode:release | Diag: /oh-my-claudecode:omc-doctor"
  ]
}
Vanilla Claude Code - Built-in commands only
{
  "companyAnnouncements": [
    "[Workflows] Dev: /plan -> /code-review | Bug: /build-fix\n[Workflows] Docs: /docs \"lib\" | Session: /save-session, /resume-session"
  ]
}

How It Works

Claude Code's companyAnnouncements field in settings.json is designed for team-wide messages. This skill repurposes it as a persistent workflow memory — a cheatsheet that Claude reads at the start of every session.

Important: companyAnnouncements must be a string[] (array). If the array has multiple items, Claude Code picks one at random per session (rotating banner). To show all lines every session, use a single array item with \n for line breaks.

settings.json                          Claude's System Prompt
┌──────────────────────────┐          ┌──────────────────────────┐
│ "companyAnnouncements": [ │   ────> │ Company announcements:   │
│   "line1\nline2\nline3"   │         │ line1                    │
│ ]                         │         │ line2                    │
└──────────────────────────┘          │ line3                    │
                                      └──────────────────────────┘
                                              │
                                              v
                                      Claude proactively suggests
                                      the right workflow chain

Syntax Convention

Symbol Meaning Example
-> Sequential steps /plan -> /tdd -> /verify
| Alternative commands /verify | /quality-gate
, Related commands /save-session, /resume-session

Supported Harnesses

Harness Commands Style Preset
Superpowers 14 skills /brainstorming, /writing-plans, /executing-plans superpowers
Everything Claude Code 40+ /plan, /tdd, /verify ecc
Oh My Claude Code 20+ /oh-my-claudecode:* + magic keywords omcc
Vanilla Claude Code Built-in /plan, /code-review minimal
Custom Your own Any combination custom

Create Your Own Preset

  1. Create a JSON file in templates/:
{
  "_comment": "My team's workflow",
  "companyAnnouncements": [
    "[MyTeam] Deploy: /build -> /test -> /deploy-staging -> /deploy-prod\n[MyTeam] Review: /lint -> /code-review -> /security-scan -> /approve"
  ]
}
  1. Each workflow line should be under ~120 characters
  2. Use [Prefix] to group related workflows
  3. Submit a PR to share with the community!

Writing Effective Announcements

Do:

  • Group by workflow phase (Dev, Quality, Docs, etc.)
  • Show the complete chain with -> arrows
  • Include alternatives with | pipes
  • Keep each line scannable at a glance

Don't:

  • List every flag and option (keep it high-level)
  • Exceed 7-10 announcement lines (Claude's attention is finite)
  • Mix harness styles in the same config

Examples

Mixed Harness Setup

Using both ECC and OMCC? Combine presets:

{
  "companyAnnouncements": [
    "[ECC] Dev: /orchestrate feature \"desc\" -> /e2e -> /verify\n[ECC] Quality: /code-review -> /refactor-clean -> /quality-gate\n[OMC] Auto: autopilot: desc | Persist: ralph: desc\n[OMC] Team: /oh-my-claudecode:team 3:executor \"task\""
  ]
}

Project-Specific Workflows

Add project-level workflows alongside harness defaults:

{
  "companyAnnouncements": [
    "[Project] PR: /plan -> /tdd -> /code-review -> gh pr create\n[Project] Hotfix: /orchestrate bugfix \"desc\" -> /e2e -> git push\n[Workflows] Quality: /code-review -> /refactor-clean -> /verify"
  ]
}

FAQ

Q: Does this slow down Claude Code? A: No. companyAnnouncements is injected into the system prompt — it costs a few hundred tokens at most and adds zero latency.

Q: Can I use this without any harness? A: Yes! Use the minimal preset for vanilla Claude Code, or create your own custom workflows.

Q: What happens if I have too many announcements? A: Keep it under 10 lines. More than that dilutes Claude's attention. Focus on workflows you actually use.

Q: Does this work with Claude Code in VS Code / JetBrains? A: Yes. settings.json is shared across all Claude Code interfaces — CLI, desktop app, IDE extensions.


Contributing

Contributions welcome! The most valuable additions are:

  1. New presets for popular harnesses or team workflows
  2. Auto-detection improvements for command discovery
  3. Documentation and workflow recipes

See CONTRIBUTING.md for guidelines.


Related Projects


License

MIT

About

Turn Claude Code's companyAnnouncements into workflow muscle memory. Presets for Superpowers, ECC, OMCC, and custom harnesses.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors