Back to Guides

/gcloud-kit:review

Review a service definition for completeness before G-Cloud submission.

Overview

Runs 40+ validation checks across all service documents to catch issues before CCS submission. Checks for completeness, consistency, character limit compliance, evidence gaps, placeholder text, and common rejection reasons.

Usage

/gcloud-kit:review My Cloud Platform

Arguments: Service name (must match an existing service directory).

Prerequisites

All service documents should exist:

  • Supplier profile (services/supplier/supplier-profile.md) — required
  • Declaration (services/supplier/declaration.md) — required
  • Service design (services/{name}/service-design.md) — required
  • SDD (services/{name}/sdd.md) — required
  • Pricing (services/{name}/pricing.md) — recommended
  • Security (services/{name}/security.md) — recommended

Output

services/{name}/review-report.md

What it does

  1. Loads all service documents
  2. Runs completeness checks — verifies all required documents exist and contain mandatory fields
  3. Performs consistency checks — cross-document validation (e.g. lot type matches across SDD, pricing, and design)
  4. Validates character and word limits against marketplace constraints
  5. Verifies evidence — checks certification numbers, expiry dates, and evidence register
  6. Detects placeholder text (e.g. [TODO], TBD, PLACEHOLDER)
  7. Checks for common CCS rejection reasons
  8. Generates a review report with pass/fail/warning status for each check

Validation checks include

  • Document existence and completeness
  • Character/word limit compliance
  • Cross-document consistency
  • Placeholder text detection
  • Evidence and certification verification
  • Pricing format validation
  • Security principle coverage
  • Feature and benefit count limits

Related commands