Files
016-pretty-table/.claude/skills/artifact/references/BC.md
T
Tirsvad b0a7414204 Add Pretty Table project: plan, accepted documents and code
Business Case, Stakeholder Analysis, Project Plan and milestone MIL-001
with review records RC-001 to RC-003, then the Python project: PrettyTable
Pokemon table, constants, pytest tests, pyproject.toml, Doxyfile, CI
workflow and README.

Task: MIL-001#1
Task: MIL-001#2
Task: MIL-001#3
Task: MIL-001#4
Task: MIL-001#5
Task: MIL-001#6
Task: MIL-001#7
Task: MIL-001#8
2026-10-07 12:02:59 +08:00

46 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Business Case (BC)
Cite in `CrossReference` only if the instance exists (`new-artifact.sh` checks this for you):
- **SA** — Stakeholders section — cite S-IDs instead of re-describing roles
- **BMC** — Cost–Benefit Assessment must agree with its cost/revenue blocks
- **BPMN** — Forward: the process that realizes the objectives
- **KPI** — Success Criteria — each criterion is operationalized by a KPI
- **UCD** — Forward: scope expressed as actors and goals
## Required sections (after Metadata / Version History)
In this order:
1. **Executive Summary** — one paragraph framing the problem and the
proposed solution.
2. **Methodological and Standards Foundation** — states the methodology
(e.g. Larman's *Applying UML and Patterns*) and quality standards (e.g.
ISO/IEC 25002/25010/25019) the rest of the document and downstream
artifacts are built on.
3. **Problem Statement** — the recurring problems that justify the project.
4. **Business Opportunity** — what becomes possible if the problem is
solved.
5. **Objectives** — concrete, verifiable statements of what the project
will achieve.
6. **Scope** — split into `## In Scope` and `## Out of Scope` subsections.
7. **Expected Benefits** — split into `### Tangible Benefits` and
`### Intangible Benefits`.
8. **Strategic Alignment** — how the project supports organizational goals.
9. **Success Criteria** — a table with explicit, measurable targets (not
aspirations).
10. **Risks** — a table with `Risk | Impact | Mitigation` columns; every
risk must have a mitigation.
11. **Assumptions** — bullet list, kept distinct from Constraints.
12. **Constraints** — bullet list, kept distinct from Assumptions.
13. **Cost–Benefit Assessment** — a table (`Costs | Benefits`); may be
qualitative if explicitly justified.
14. **Stakeholders** — a table referencing exact stakeholder IDs from the
project's Stakeholder Analysis (e.g. `S01`, `S07`) if `SA` exists per
the CrossReference check above. **Never re-describe stakeholder roles
inline instead of citing their IDs** — this is the single most common
defect found when reviewing Business Cases (see `QC-BC-001`'s Common
Defects).
15. **Recommendation** — a single, unambiguous "proceed" or "do not
proceed" statement.