agentleFS
bookchaowalitbookchaowalit/platform-agent-skills/business-analysis/SKILL.md

business-analysis

Skill0 starsChanged 8 days agoApache-2.0View on GitHub

Run an evidence-backed Business Analyst lifecycle for ambiguous business needs, product discovery, client work, process improvement, requirements, user stories, traceability, change control, UAT, and handoff. Use when a request needs stakeholder analysis, BRD-style requirements, acceptance criteria, business decisions, or measurable benefits.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 7 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read dashboard/CURRENT-STATE.md, docs/ARCHITECTURE.md, and docs/AI-AGENT-GUIDE.md before substantial work.

    line 16
  2. Very specific:

    Read roles/business-analyst/README.md and PROCESS.md from the bookchaowalit/knowledge-base checkout (set SOLO_KNOWLEDGE_ROOT.

    line 18
  3. Distinctive:

    Keep drafts, approved baselines, rejected changes, and evidence separate.

    line 54
  4. Distinctive:

    Use placeholders only in templates.

    line 59
  5. Distinctive:

    Keep live actions in SQLite and use Markdown for durable evidence and reusable procedures.

    line 61
  6. Distinctive:

    Stop when there is no accountable owner, decision path, or usable evidence.

    line 66
  7. Distinctive:

    Stop and ask for direction before sending external messages, changing production, spending money, exposing private data, or …

    line 67
  8. Distinctive:

    Treat conflicting or incomplete tool results as unknowns and record them.

    line 71
  9. Distinctive:

    Do not claim UAT, acceptance, benefits, or publication without evidence.

    line 72

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “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

Business Analysis — Solo Empire

Overview

Turn a vague request into an approved, traceable, testable, and handoff-ready business outcome. Use the role charter and process as the governing contract; use only the artifact templates required by the bounded initiative.

Establish context

  • Read dashboard/CURRENT-STATE.md, docs/ARCHITECTURE.md, and docs/AI-AGENT-GUIDE.md before substantial work.
  • Read roles/business-analyst/README.md and PROCESS.md from the bookchaowalit/knowledge-base checkout (set SOLO_KNOWLEDGE_ROOT; default is the knowledge-base sibling of this checkout); they no longer live in this repository.
  • Identify the owning boundary, accountable decision maker, affected users, data classification, current status, and live task source.
  • Inspect git status and preserve unrelated changes.

Lifecycle

  1. Intake: state the business problem, outcome, owner, scope, non-goals, and decision path. Create a concrete SQLite task for the next action.
  2. Discovery: use discovery-plan.md and stakeholder-map.md. Gather permitted evidence, interviews, workflows, constraints, and unanswered questions.
  3. Options: use business-case.md when the decision needs trade-offs, investment, risk, or benefits analysis.
  4. Process analysis: use as-is-to-be-process.md to model current behavior, target behavior, gaps, rules, exceptions, and controls.
  5. Requirements: use business-requirements.md and user-story.md. Make each priority item testable, sourced, prioritized, and owned.
  6. Baseline: obtain accountable approval, version the baseline, and start requirements-traceability-matrix.md. Include the KPI definitions and targets from templates/sdlc/kpi-and-instrumentation-plan.md (owned by product-management) in the baseline; for client work the client signs them at G5 with the requirements.
  7. Change control: never silently edit an approved baseline. Use change-request.md and decision-log.md, then update the RTM after a decision.
  8. UAT: use uat-plan-report.md. Distinguish smoke checks, technical tests, UAT, business acceptance, defects, waivers, and evidence.
  9. Handoff: use handoff-benefits-review.md. Transfer ownership, limitations, support boundaries, metrics, evidence, and the next review task. Cite KPI IDs from the KPI plan; do not define metrics again.
  10. Benefits follow-up: the Actual column of the benefits review cites the latest templates/sdlc/outcome-review.md. Each outcome-review decision that changes scope goes through change-request.md and the RTM.

Artifact rules

  • Keep drafts, approved baselines, rejected changes, and evidence separate.
  • Link objective → requirement → acceptance criterion → test/evidence → release → KPI → experiment → outcome review, as in the SDLC traceability chain (templates/sdlc/README.md).
  • Record source, rationale, priority, owner, status, approver, and date.
  • Use placeholders only in templates; do not leave them in an approved artifact.
  • Store reusable blank starters under templates/roles/business-analyst/.
  • Keep live actions in SQLite and use Markdown for durable evidence and reusable procedures.

Stop conditions and approvals

  • Stop when there is no accountable owner, decision path, or usable evidence.
  • Stop and ask for direction before sending external messages, changing production, spending money, exposing private data, or deleting/overwriting.
  • Route legal, tax, employment, medical, or regulated questions to the proper expert; do not convert analysis into professional advice.
  • Treat conflicting or incomplete tool results as unknowns and record them.
  • Do not claim UAT, acceptance, benefits, or publication without evidence.

Quality gate

Before handoff, verify:

  • Accountable owner approved the baseline or disposition.
  • Priority requirements have acceptance criteria.
  • RTM links requirements to tests/evidence.
  • Changes have impact assessment and decision records.
  • UAT scope, environment, tester, result, and evidence are recorded.
  • Known limitations, support owner, KPI baseline, and next review exist.
  • The first outcome review is scheduled (G11) and benefits cite KPI IDs.

Handoff

Report the artifacts created, baseline/version, approvals, evidence links, open risks, unresolved assumptions, tests/UAT performed, known limitations, and the next safe action. Run task roles:check before declaring the role package structurally complete.

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.