agentleFS
jamiemilljamiemill/layers-skills/skills/layers-orient/SKILL.md

layers-orient

Skill307 starsChanged 6 months agoMITView on GitHub

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

3 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the designer has a deadline or constraint that changes the calculus, acknowledge it.

    line 93

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/layers-orient

Assumes /layers-intro has been loaded for framework context.

Orient is a rapid diagnostic — the front door for finding the live decisions the other skills then work. It maps the current state of decisions across all seven layers, identifies the bottleneck — the lowest layer with unresolved or risky decisions — and recommends where to focus next.

It is not a deep dive into any layer. That's what the individual layer skills are for. Orient answers the prior question: which layer deserves attention most urgently? Keep it fast and light — the output is a short audit and one recommendation, not a report.

What it assesses:

  • Whether key decisions have been made at each layer, and how solidly
  • Whether decisions treated as solid are actually assumptions
  • Which layer is the most foundational with unresolved work, creating risk for everything above

Quality signals — when orient is done well:

  • The bottleneck layer is specifically named, not vaguely gestured at
  • Assumed layers are distinguished from Strong ones — they require different responses
  • The recommendation connects to a specific skill with a clear reason

Guided session

Describe your design situation and what prompted you to pick it up, or say "let's orient" to start.

(Capture is opt-in and light — see /layers-intro. For orient, the audit table itself is usually all that's worth keeping.)

Then ask:

  1. What product or feature are you working on?
  2. What design challenge are you facing right now?
  3. How far along is this work — early exploration, active design, or fixing something in an existing product?

Listen for clues about which layers have already been worked through and which are thin or missing.


Layer audit

Work through each layer with one or two targeted questions. Rate each as: Strong / Partial / Assumed / Weak / Not started / N/A

Observed behaviour "What user research do you have? Have you spoken to users, observed them, or have analytics? Or is this mostly based on what the team believes users do?"

The domain "How well do you understand the space this product operates in — the real-world concepts, terminology, and how users think before your product enters the picture?"

User needs "Can you articulate what users are trying to achieve — not in features, but the underlying job and why it matters? Do you have job stories or equivalent?"

Product & service strategy "Do you know which specific user need this work targets and what business outcome it's meant to move? Is the connection between opportunity and business goal explicit, or informal?"

Conceptual model "Does the product have a clear model of the objects it works with — the things that exist, how they connect, and what vocabulary you use? Is this shared across the team, or does each person have their own version?"

Interaction structure and flow "Do you have a clear picture of the key user journeys — places, steps, decision points? A breadboard, rough flow, working code, or a description you can narrate?"

Surface "Is there an existing design system, visual language, or component library this needs to fit into?"


Decision landscape

Produce the audit as a table:

Layer                      | State       | Notes
---------------------------|-------------|----------------------------------------
Observed behaviour         |             |
The domain                 |             |
User needs                 |             |
Product & service strategy |             |
Conceptual model           |             |
Interaction structure      |             |
Surface                    |             |

Bottleneck analysis

Identify the bottleneck layer: the lowest layer with Weak, Assumed, or Not started state. State it clearly: what decisions are missing, and what risk does that create for the layers above?

Also flag assumed layers — layers treated as decided but not verified. Assumptions that look solid are often where the most dangerous decisions hide.

If the designer has a deadline or constraint that changes the calculus, acknowledge it. Sometimes the right move isn't the most foundational one — name that tradeoff explicitly rather than ignoring it.


Recommendation

Recommend a specific skill to run next and why:

  • Conceptual model → /layers-conceptual-model
  • Product strategy → /layers-product-strategy
  • User needs → /layers-user-needs
  • Domain → /layers-domain
  • Interaction structure → /layers-interaction-flow
  • Observed behaviour → /layers-observed-behaviour

Close with: "Want to run [skill] now, or is there something in this picture to push back on first?"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.