copilot-instructions: Instructions file for GitHub Copilot

Template Usage

ALWAYS use template .github/templates/effort-estimation-poc-mvp-template.md as base. Do not assemble the final estimation document directly from this instruction file; use the template for structure, placeholders, and section order. UCP (Use Case Points): requirements analysis and effort estimation for POC/MVP. Goal: define scope and estimate effort to evolve from POC to MVP using UCP.

POC→MVP Flow

Context, problem, personas, goals, metrics.

POC Design

• Prove technical/value hypothesis
• Minimal scope, short timeline, clear success criteria
• Outputs with minimal backlog, technical design, test plan and result
• Inline snippets below are illustrative only and must not replace the template structure.

// POC design (front): hooks/composables first; minimal UI; loading/error/success states
const { data, loading, error } = useApi('/endpoint');
if (loading) return <Spinner />;
if (error) return <Error message={error.message} />;

// POC design (back): stub endpoints; ProblemDetails; structured logs
[HttpGet]
public async Task<ActionResult<OrderDto>> GetOrder(Guid id)
{
    // Stub implementation with structured logging
    _logger.LogInformation("Getting order {OrderId}", id);
    return new OrderDto { Id = id, Status = "Pending" };
}

POC Validation

Test with 3–5 users; measure success rate, time and errors; gate go/adjust/drop.

MVP Requirements

• Value‑based backlog (RICE/ICE)
• NFRs security/performance/availability/A11Y/i18n/privacy
• Data with schema/migrations/idempotent seed/indexes
• API with versioned contracts, rate limiting, idempotency
• Quality with unit (xUnit), integration (NUnit), critical E2E and CI/CD

Delivery

Roadmap and sprints; risks and mitigations; dependencies; rollout/rollback; metrics (DAU, task success, P95 latency, errors).

UCP Formulas

• UUCP = UAW + UUCW + UCRW
• UCP = UUCP × TCF × EF
• Base effort (hours) = UCP × hours_per_point
• Extra QA = Base effort × TESTS_PERCENT
• Total effort = Base effort + Extra QA