Skip to content

Adapted my personal workflow tool to something my whole team could use

How to keep your agent focused on the right things.

I found my personal usage of Claude and Cursor increased immediately after dedicating a relatively small amount of time to build one thing: a context framework. The framework took a rambling CLAUDE.md file and turned it into a map of my work that gives Claude the reliability I need to scale my output and my team’s impact.

Instead of continually correcting my agent that it had wandered away from the plot, I gave it a map laying out the context about what I’m working on, who I’m working with, and what success means.

CLAUDE.md            # short identity + router: who you are, how you work, where things live
context/
  profile            # role, goals, what you own
  team               # who's who, how you work together
  stakeholders       # what each person cares about (keep private)
  products           # the areas you own
  writing-style      # tone by audience
  backlog            # initiatives + follow-ups
reference/           # deeper specs, pulled in only when relevant

Once I began to see the impact compound in my personal workflow, I created one that was more aligned with our larger organization’s goals. In order to share it easily across the org, I added it to an internal shared skills repo as a Claude plugin, including company context, templates, and more.

SKILL.md                          # the interactive setup skill
references/
  interview-questions.md          # the full question set, per file
  storage-locations.md            # adapting the framework to markdown, Drive, Notion, etc.
templates/
  CLAUDE.md                       # the router template
  context/                        # profile, team, stakeholders, products, writing-style, backlog
  reference/                      # the on-demand spec layer convention
  deliverables/                   # 1:1 note and daily/weekly note starting points

The context framework turned a series of independent chat threads into a collaborator that I can rely on to remember the right things at the right time. I’ve adapted my original setup for a more general audience, so feel free to try it yourself and see how it can help you and your team.

Role
Product Manager
Repository
ryanjoehalsey/skills