agentleFS
dithiothreitoldithiothreitol/ea-skills/skills/ea-stakeholders/SKILL.md

ea-stakeholders

Skill3 starsChanged 3 months agoMITView on GitHub

Identify stakeholders and their concerns from the fact register and plan which views will frame them (ISO 42010). Use when asked who the architecture is for, when starting documentation work, when views exist without declared concerns, or when ISO001-ISO006 findings need resolving. Produces the stakeholder/concern register and a view plan.

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:

    Keep it small and true: three stakeholders with confirmed concerns beat ten with guessed ones.

    line 47

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 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

Stakeholders, concerns and the view plan

ISO 42010's core discipline is a closed loop: every stakeholder holds concerns, every concern is framed by at least one view, every view exists to frame someone's concern. The validator enforces the loop (ISO001-ISO006); your job is to fill it with real people and real questions.

Where they come from

The fact register, not your imagination. Interview participants, named owners in inventories, roles the sources mention (auditors, service desk, infrastructure team) -- these are stakeholder candidates with evidence behind them. The owner fields already in the model tell you who is accountable for what.

A concern is a question the stakeholder needs the architecture to answer, phrased so a view either answers it or visibly fails to:

  • good: "How exposed is order capture to a single point of failure?"
  • bad: "availability" (not a question), "the CIO cares about IT" (not answerable).

The register

Stakeholders and concerns live in the model DSL (typically model/<zone>/stakeholders.yaml) and ride the same staging -> approved flow as everything else:

stakeholders:
  - id: stakeholder-cio
    name: CIO
    description: Owns the application portfolio and its budget.
    concerns: [concern-portfolio-rationalisation]

concerns:
  - id: concern-portfolio-rationalisation
    statement: Which applications support which capability, and where is investment or retirement due?

Keep it small and true: three stakeholders with confirmed concerns beat ten with guessed ones. If you are inferring a concern the sources never voice, that is a clarification question for the stakeholder, not an entry -- record it in facts/questions/ with the text that made you suspect it and the stakeholder as addressedTo, so it is asked rather than forgotten (ea-intake describes the record).

The view plan

For each concern, decide which view frames it and record the mapping on the view:

views:
  - id: capability-realization
    concerns: [concern-portfolio-rationalisation]

Match concerns to ArchiMate viewpoint styles rather than inventing formats: portfolio questions -> Capability Map; availability/integration questions -> Layered or Application Cooperation; obligation questions -> Motivation (requirements with their appliesTo bindings). One view may frame several concerns; a concern may need a new view -- propose it with an include list and hand the modelling to ea-views.

Closing the loop

easkills validate --root <repo> --zone staging

Work the ISO findings honestly: ISO006 (concern nobody holds) means find the person or drop the concern; ISO003 (concern no view frames) means plan a view or record it as an accepted gap in your report; ISO005 (view framing nothing) means either the view earns its place by naming a concern or it is decoration. Do not silence findings by inventing stakeholders -- an invented stakeholder makes the whole description untrustworthy.

Reporting back

List the loop: who -> what they ask -> which view answers it. Then the gaps: concerns awaiting a view, questions for stakeholders you could not confirm, and views that still frame nothing and why.

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.