EasyPlatform Business Feature Documentation
Generate comprehensive business feature documentation following the GOLD STANDARD template.
⚠️ MUST READ References
IMPORTANT: You MUST read these reference files for complete protocol. Do NOT skip.
- •⚠️ MUST READ
.claude/skills/shared/business-docs-26-sections.md— 26-section template structure - •⚠️ MUST READ
.claude/skills/shared/bdd-gherkin-templates.md— BDD/Gherkin scenario templates - •⚠️ MUST READ
.claude/skills/shared/anti-hallucination-protocol.md— validation checkpoints, confidence levels - •⚠️ MUST READ
docs/features/README.ExampleFeature1.md— gold standard example - •⚠️ MUST READ
docs/templates/detailed-feature-docs-template.md— full template - •⚠️ MUST READ
docs/templates/detailed-feature-docs-template.ai.md— AI companion template
[CRITICAL] MANDATORY CODE EVIDENCE RULE
EVERY test case MUST have verifiable code evidence. This is non-negotiable.
Evidence Format
**Evidence**: `{RelativeFilePath}:{LineNumber}` or `{RelativeFilePath}:{StartLine}-{EndLine}`
Valid vs Invalid Evidence
| Valid | Invalid |
|---|---|
ErrorMessage.cs:83 | {FilePath}:{LineRange} (template) |
Handler.cs:42-52 | SomeFile.cs (no line) |
interviews.service.ts:115-118 | "Based on CQRS pattern" (vague) |
Phase 1: Module Detection & Context Gathering
Step 1.1: Identify Target Module
- •User explicitly specifies module name
- •Feature name/domain implies module
- •Search codebase for feature-related entities/commands
Step 1.2: Read Existing Documentation
1. Read docs/BUSINESS-FEATURES.md (master index)
2. Read docs/business-features/{Module}/INDEX.md (if exists)
3. Read docs/business-features/{Module}/README.md (if exists)
4. Identify what already exists vs what needs creation/update
Step 1.3: Codebase Analysis
Gather evidence from source code:
- •Entities:
src/Backend/*.Domain/Entities/ - •Commands:
src/Backend/*.Application/UseCaseCommands/ - •Queries:
src/Backend/*.Application/UseCaseQueries/ - •Controllers:
src/Backend/*.Api/Controllers/ - •Frontend:
src/Frontend/apps/orsrc/Frontend/libs/apps-domains/
Phase 2: Documentation Generation
⚠️ MUST READ .claude/skills/shared/business-docs-26-sections.md for the full 26-section structure, format templates, and quality checklist.
Key requirements:
- •All 26 mandatory sections in correct order
- •Quick Navigation by Role table
- •FR-{MOD}-XX format for business requirements
- •TC-{MOD}-XXX format with GIVEN/WHEN/THEN for test cases
- •Evidence with
{FilePath}:{LineRange}format
Phase 2.5: AI Companion Generation
Output: docs/business-features/{Module}/detailed-features/README.{Feature}.ai.md
10 sections (~300 lines): Context, File Locations, Domain Model, API Contracts, Business Rules, Patterns, Integration, Security, Test Scenarios, Quick Reference.
Compression rules: Tables over prose, paths over descriptions, signatures over examples, decisions over explanations.
Phase 3: Master Index Update
After creating/updating module docs, update docs/BUSINESS-FEATURES.md:
- •Read current content
- •Verify module is listed
- •Add link if missing
Anti-Hallucination Protocol
- •Every feature claim MUST have code reference with file path and line numbers
- •Read actual source files before documenting
- •Never assume behavior without code evidence
- •Checkpoint: "Have I read the actual code? Are my references accurate?"
Quality Checklist
- • All 26 mandatory sections present in correct order
- • Quick Navigation by Role included
- • Test cases use TC-{MOD}-XXX with GIVEN/WHEN/THEN
- • All code references verified with actual files
- • Master index (BUSINESS-FEATURES.md) updated
- • AI companion file created (<= 300 lines)
IMPORTANT Task Planning Notes
- •Always plan and break many small todo tasks
- •Always add a final review todo task to review the works done at the end to find any fix or enhancement needed