Web Development Discovery Checklist for B2B Requirements
Web Development projects usually don’t blow up because the team “can’t build it.” They blow up because everyone built a different version of it in their head. A stakeholder assumes SSO is included. Ops assumes approvals mirror the current process. Someone mentions “a simple Salesforce sync” after estimates are signed. Then scope expands, timelines slip, and the budget gets spent on rework.
Discovery is where you prevent that. It’s a short, structured push to get the right people in the room, turn assumptions into decisions, and write requirements you can test, estimate, and operate. When discovery is done well, integrations, security, and governance stop being vague promises and become concrete rules with owners.
This checklist gives you the prompts and sample questions to run a B2B discovery that holds up under real-world pressure—multiple stakeholders, hidden systems, compliance constraints, and “we need this live by Q3” deadlines. It’s vendor-neutral, based on what consulting teams see repeatedly in custom builds, and it’s designed to help you walk into kickoff with fewer unknowns and fewer expensive surprises.
Discovery Kickoff Checklist: Stakeholders, Goals, and Success Metrics
Integrations and security issues hide in the fine print because the wrong people are missing from kickoff. In Web Development discovery, your first job is to name who decides, who supplies facts, and who signs off. If you cannot answer those three, scope and estimates drift.
- Executive sponsor: owns business outcome and approves budget tradeoffs.
- Product owner: sets priorities, accepts work, manages the backlog.
- Operations lead: owns the real workflow, exceptions, and handoffs.
- IT owner: controls environments, domains, identity, and integrations.
- Security and compliance: defines controls (SOC 2, HIPAA, PCI DSS) and evidence needs.
- Customer support or success: brings ticket patterns and top failure points.
- Finance or procurement: clarifies vendor onboarding, invoicing, and contract constraints.
- End-user reps: validate usability, accessibility, and daily tasks.
Write down each person’s decision rights in one line. Example: “IT approves SSO approach and production access,” “Ops approves workflow steps,” “Security approves logging and retention.”
Goals And Success Metrics You Can Actually Measure
Discovery fails when goals sound like “modernize” or “improve UX.” Convert goals into metrics with a baseline and a target date, then attach an owner.
- Revenue: increase qualified demo requests from 120 to 180 per month (track in HubSpot, a CRM and marketing platform).
- Cycle time: reduce quote-to-approval from 5 business days to 2 (measure in Salesforce or your ERP).
- Support load: cut “password reset” tickets by 30% after SSO rollout (track in Zendesk, a support ticketing system).
- Quality: keep Sev-1 incidents at 0 in the first 30 days post-launch (track in Jira and PagerDuty).
- Compliance: meet HIPAA access logging and retention expectations for any PHI.
Kickoff questions that prevent misalignment: “What decision can only the sponsor make?”, “What would make you pause the project?”, “Which metric proves this worked?”, “Who can approve copy, legal text, and pricing changes?”, “What systems are off-limits for integration?”
Requirements Checklist: Scope, Users, Workflows, and Content Ownership
“Who approves pricing changes?” sounds simple until it forces a real Web Development requirement: what is editable, by whom, and what must go through review. This section turns those approval questions into concrete scope, user, and workflow decisions you can estimate and build.
- Define in-scope vs out-of-scope: list features as verbs, not nouns (ex: “request a demo,” “route to SDR,” “export CSV”).
- Set MVP boundaries: write what ships in v1 and what waits for phase 2. If someone says “later,” name the later release.
- Confirm success-critical pages and functions: login, account, pricing, docs, support, admin, search, forms, dashboards.
- Identify hard constraints: “system X is off-limits,” “must use Okta,” “must run on AWS,” “no cookies until consent.”
Users, Roles, and Permissions Checklist
Roles drive cost because they drive screens, rules, and test cases. Capture roles as permission sets, not org chart titles.
- User types: anonymous visitor, customer, partner, internal ops, admin, super-admin.
- Auth requirements: SSO (Okta, Microsoft Entra ID), passwordless, MFA, session timeouts.
- Authorization rules: who can view, create, edit, approve, publish, export, delete.
- Data boundaries: account-level separation, region-based access, “see only my team.”
Map each critical journey end-to-end, including handoffs: “lead submits form, Salesforce creates lead, Slack notifies channel, SDR assigns owner, customer receives email.” Then capture edge cases that break timelines if ignored.
- Edge cases: duplicates, missing required fields, failed payments, API timeouts, approvals stuck, user invited with wrong email domain.
- Exception handling: what the user sees, what gets retried, who gets alerted.
Content ownership is a requirement, not a process note. Decide who writes, reviews, and publishes each content type (marketing pages, legal, help docs, product copy), where it lives (CMS like Contentful or WordPress), and what needs approval (legal, security, brand).
How Do You Capture Integrations, Data, and Non-Functional Requirements Without Surprises?
That “lead submits form, Salesforce creates lead, Slack notifies channel” flow breaks when one field name, one API limit, or one latency assumption is wrong. In Web Development discovery, treat integrations and non-functional requirements as first-class scope, with owners and testable rules.
- List systems of record: Salesforce (CRM), NetSuite (ERP), HubSpot (marketing), Zendesk (support), SharePoint (docs), Stripe (payments). For each, name the data owner and who can grant API access.
- Inventory integration methods: REST/GraphQL APIs, webhooks, SFTP file drops, database reads, iPaaS tools like MuleSoft or Workato. Write down what is allowed and what is prohibited.
- Define data objects and fields: “Lead,” “Account,” “Order,” “Ticket.” Capture field names, types, required vs optional, validation rules, and picklists. Ask: “Which fields drive routing, pricing, or compliance reporting?”
- Set sync rules: source of truth, direction (one-way vs bi-directional), frequency (real time, hourly, nightly), conflict handling, idempotency, and retry behavior.
- Plan failure behavior: what happens when Salesforce is down, a webhook arrives twice, or an API returns 429 rate limits. Require an error queue and a manual reprocess path.
- Require auditability: event logs for creates/updates, who changed what, and correlation IDs across services.
Non-Functional Requirements Checklist for Web Development
- Performance: set page and API targets (for example, “P95 API response under 500ms” and “largest pages load under 3 seconds on 4G”). Define where you measure (Datadog or New Relic).
- Availability: uptime target, maintenance windows, and RTO/RPO expectations if you have them.
- Accessibility: require WCAG 2.2 AA conformance and name who signs off (legal, compliance, or product). Use axe DevTools or Lighthouse for checks.
- SEO and AI Visibility: confirm indexable pages, canonicals, robots.txt, XML sitemaps, schema.org structured data, and server-side rendering needs. Validate in Google Search Console.
- Analytics: define events, conversions, and identity rules up front. Specify Google Analytics 4 and Google Tag Manager ownership.
- Observability: logging, metrics, traces, alert thresholds, and an on-call path (PagerDuty). Require dashboards before go-live.
Security-First Discovery Checklist: The Questions Most Teams Skip
One wrong field name can break an integration. One wrong security assumption can create a breach. In Web Development discovery, security has to be specific enough to test, audit, and operate, not a generic “we’ll be secure” statement.
- Define your crown jewels: What data or actions would hurt most if exposed or abused (customer lists, pricing rules, invoice downloads, admin actions)?
- Pick a threat-modeling frame: Use STRIDE (Spoofing, Tampering, Repudiation, Information Disclosure, Denial of Service, Elevation of Privilege) so the team names realistic threats per workflow.
- Clarify trust boundaries: Which calls cross the public internet, a VPN, a VPC, or a third-party SaaS like Salesforce?
- Confirm who can approve risk: Name the person who can accept a control gap when schedule pressure hits.
Ask one contrarian question early: “If we ship exactly what’s written, where do we still get hacked?” It forces concrete answers.
Authentication, Authorization, PII, and Evidence
- Authentication (authN): Do you require SSO with Okta or Microsoft Entra ID? Is MFA mandatory? What is the session timeout, and do you need device trust or IP allowlists?
- Authorization (authZ): Write rules as sentences: “Ops users can export CSV for their account only.” Confirm object-level and field-level permissions where needed.
- PII and sensitive data: List fields considered PII (email, phone, IP address) and any regulated data (PHI for HIPAA, card data for PCI DSS). Decide where each field can appear (UI, logs, analytics events, exports).
- Encryption expectations: Require TLS in transit. Decide whether you need encryption at rest for databases, object storage, and backups (common on AWS RDS and S3).
- Secrets management: Specify where API keys live (AWS Secrets Manager, HashiCorp Vault) and who can read them.
- Logging and audit trails: Define audit events (login, role change, export, delete). Set retention and access rules. Decide where logs go (Datadog, Splunk, or AWS CloudWatch) and who reviews alerts.
- Data retention and deletion: State retention periods per data type and the deletion trigger (contract end, user request). Include legal hold requirements if applicable.
- Compliance evidence: If you need SOC 2 controls, map which artifacts you must produce (access reviews, change logs, incident response records). Use AICPA SOC 2 guidance as the reference point.
Governance Checklist: Estimates, Change Control, Acceptance Criteria, and Launch Readiness
If you cannot agree on who accepts work and how change gets approved, Web Development estimates turn into guesses. Governance is the set of decisions that keeps scope, security fixes, and integrations from quietly expanding your timeline.
- Pick a delivery model: fixed-scope with formal change orders, time-and-materials with a prioritized backlog, or a hybrid (fixed MVP, flexible enhancements). Write the model in the SOW so procurement and stakeholders cannot reinterpret it mid-project.
- Set sprint cadence and ceremonies: sprint length (often 2 weeks), demo schedule, backlog refinement, and who must attend. Missing decision-makers in demos creates rework.
- Define estimate inputs: what artifacts estimates rely on (approved scope list, integration inventory, non-functional targets, security assumptions). If any input is “TBD,” label the estimate “preliminary” and list what changes it.
- Clarify environments and access: who provisions dev/stage/prod, who manages DNS and certificates, and how vendors get access (VPN, bastion, IP allowlists). This is a common hidden blocker.
- Assign QA ownership: who writes test cases, who runs UAT, and what tooling you use (Jira for test tickets, BrowserStack for cross-browser checks). Name the business owner who signs UAT.
- Write acceptance criteria per story: include happy path, edge cases, analytics events, and error messages. “Works like the old site” is not a criterion.
- Define “done”: code merged, automated tests pass, security checks complete, documentation updated, and monitoring dashboards exist (Datadog or New Relic).
- Set change control rules: what counts as change, who approves it, and how you trade scope for time. Require a written impact summary (cost, schedule, risk) for every change request.
Launch Readiness Checklist for Web Development
- Cutover plan: redirect map, content freeze date, rollback steps, and who is on the go-live call.
- Operational readiness: on-call rotation, alert thresholds, incident runbook, and ownership for integrations that fail after hours.
- Post-launch verification: GA4 conversions, Google Search Console coverage, form-to-CRM flow, and access logs for sensitive actions.
Two questions to ask in discovery: “What decision can block production release?” and “What change would require legal, security, or finance approval?”
Final Discovery Deliverables Template and Next Steps
A production release gets blocked when the team cannot point to a single, approved source of truth. The whole point of Web Development discovery is to produce a small set of artifacts that remove ambiguity, support an estimate, and survive stakeholder turnover.
Use this deliverables template as your “done” checklist for discovery. If any item is missing, you are guessing.
- Requirements document (PRD): problem statement, goals and metrics, in-scope and out-of-scope, assumptions, constraints, definitions, and acceptance criteria per major feature.
- Prioritized backlog: epics and user stories ranked by value and dependency, tagged as MVP vs Phase 2. Keep it in Jira or Azure DevOps so scope changes stay visible.
- User journeys and workflow maps: the happy path plus exceptions, approvals, and handoffs. Include who owns each step in operations.
- Integration and data spec: systems of record, API endpoints or file exchanges, required fields, validation rules, sync frequency, retry rules, and audit events.
- Non-functional requirements: performance targets (for example P95 API under 500ms), availability expectations, WCAG 2.2 AA accessibility, SEO and AI visibility requirements, analytics events, and observability (logs, metrics, traces, alerts).
- Architecture outline: environment plan (dev, staging, prod), hosting choice (AWS, Azure, GCP), identity approach (Okta, Microsoft Entra ID), and key component boundaries. Keep it at the “explain it on one page” level.
- Risk register: top risks, impact, likelihood, mitigation, owner, and due date. Include vendor dependencies and any compliance evidence you must produce (SOC 2, HIPAA, PCI DSS).
Next Steps to Turn Discovery Into an Accurate Build Plan
- Run a requirements review: get sponsor, ops, IT, and security to sign off on scope boundaries and acceptance criteria.
- Do a dependency pass: confirm API access, sandbox environments, SSO setup, and data owners can support the timeline.
- Estimate by slice: estimate MVP epics separately from Phase 2, then add explicit contingency for unknowns you kept in the risk register.
- Lock change control: define who approves scope changes and what triggers legal, security, or finance review.
If you want fewer surprises, treat discovery deliverables as approval gates, not paperwork. When JAMD Technologies runs discovery, the goal is simple: every requirement becomes testable, every risk gets an owner, and the estimate ties back to written scope.