{
  "$contract": "quailpages.style-guide",
  "version": "1.1",
  "purpose": "Canonical, normalized source of truth for a brand's current visual identity. Primary brand input for Quail Pages theme building and a normal companion input for site building. Designed for downstream reasoning and execution without requiring the intake transcript.",
  "contractState": {
    "status": "in-progress",
    "completeness": null,
    "lastReviewed": null,
    "normalizedFrom": [],
    "notes": []
  },
  "authority": {
    "rule": "Downstream systems must preserve locked and authoritative decisions. Approved decisions may be applied normally. Preferred decisions may guide exploration but are not immutable. Unknown or undecided fields must not be silently invented as brand truth.",
    "sources": [],
    "precedence": [
      "this contract's locked decisions and authoritative assets",
      "authoritative external brand standards referenced by this contract",
      "this contract's approved decisions",
      "this contract's preferred decisions",
      "supporting references",
      "downstream model interpretation"
    ],
    "rules": [
      "Existing approved applications are evidence of applied brand behavior when higher-authority guidance is silent.",
      "Observed application behavior must not silently override authoritative standards.",
      "Specificity and authority are independent: precise observation does not automatically become a locked brand rule."
    ]
  },
  "identity": {
    "organizationName": {
      "value": null,
      "status": "unknown"
    },
    "displayName": {
      "value": null,
      "status": "unknown"
    },
    "character": {
      "desired": [],
      "avoid": [],
      "tensionsToBalance": [],
      "status": "unknown",
      "notes": []
    }
  },
  "assets": {
    "authoritative": [],
    "assetShape": {
      "id": "unique-asset-id",
      "role": "logo-mark | wordmark | lockup | favicon | font | image | pattern | other",
      "uriOrPath": null,
      "variant": null,
      "status": "approved | locked",
      "usage": null,
      "prohibitions": [],
      "notes": []
    }
  },
  "logoSystem": {
    "status": "unknown",
    "concept": null,
    "primaryAssetId": null,
    "markAssetId": null,
    "wordmarkAssetId": null,
    "lockups": [],
    "variants": [],
    "clearSpace": {
      "value": null,
      "status": "unknown",
      "notes": []
    },
    "minimumSize": {
      "value": null,
      "status": "unknown",
      "notes": []
    },
    "backgroundUsage": {
      "light": {
        "assetId": null,
        "status": "unknown",
        "notes": []
      },
      "dark": {
        "assetId": null,
        "status": "unknown",
        "notes": []
      },
      "complex": {
        "rule": null,
        "status": "unknown",
        "notes": []
      }
    },
    "reproduction": {
      "gradient": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "flatColor": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "monochrome": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "black": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "white": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "smallUse": {
        "status": "unknown",
        "assetIds": [],
        "notes": []
      },
      "embroidery": {
        "status": "not-applicable",
        "assetIds": [],
        "notes": []
      },
      "engraving": {
        "status": "not-applicable",
        "assetIds": [],
        "notes": []
      }
    },
    "usageRules": [],
    "prohibitedTreatments": [],
    "notes": []
  },
  "colorSystem": {
    "status": "unknown",
    "palette": [],
    "colorShape": {
      "id": "color-id",
      "name": null,
      "value": null,
      "format": "hex",
      "roles": [],
      "status": "approved | locked | preferred",
      "notes": []
    },
    "gradients": [],
    "surfaceRoles": [],
    "textRoles": [],
    "accessibility": {
      "status": "unknown",
      "rules": [],
      "knownLimitations": [],
      "notes": []
    },
    "usageRules": [],
    "prohibitedUses": []
  },
  "typography": {
    "status": "unknown",
    "families": [],
    "familyShape": {
      "id": "font-id",
      "family": null,
      "source": null,
      "licenseOrPermission": null,
      "roles": [],
      "weights": [],
      "styles": [],
      "status": "approved | locked | preferred",
      "notes": []
    },
    "wordmarkTreatment": {
      "familyId": null,
      "tracking": null,
      "case": null,
      "status": "unknown",
      "notes": []
    },
    "hierarchy": {
      "status": "unknown",
      "display": null,
      "heading": null,
      "body": null,
      "interface": null,
      "caption": null,
      "notes": []
    },
    "usageRules": [],
    "prohibitedUses": []
  },
  "visualLanguage": {
    "status": "unknown",
    "artDirection": [],
    "shapeLanguage": [],
    "surfaceLanguage": [],
    "spacingAndDensity": [],
    "depthAndEffects": [],
    "motion": [],
    "usageRules": [],
    "antiPatterns": [],
    "notes": [
      "Preserve observational fidelity: when discovery found a repeated applied-brand pattern that materially helps design, retain enough concrete detail for a downstream designer to act without revisiting the source.",
      "A visual-language entry may be specific without being locked. Distinguish what the authoritative brand defines from what current applications repeatedly demonstrate and from what normalization interprets.",
      "Where useful, describe relative behavior rather than inventing false precision—for example, round over square; restrained rounding on large surfaces versus stronger rounding on compact controls; or light neutral surfaces with brand color used as emphasis.",
      "When exact implementation evidence is reliably known, it may be preserved as evidence while explicitly stating that it is not an authoritative brand specification."
    ]
  },
  "imagery": {
    "status": "unknown",
    "photography": {
      "status": "unknown",
      "direction": [],
      "subjectGuidance": [],
      "treatment": [],
      "avoid": [],
      "notes": []
    },
    "illustration": {
      "status": "unknown",
      "direction": [],
      "avoid": [],
      "notes": []
    },
    "iconography": {
      "status": "unknown",
      "direction": [],
      "avoid": [],
      "notes": []
    },
    "patternsAndTexture": {
      "status": "unknown",
      "direction": [],
      "avoid": [],
      "notes": []
    }
  },
  "voiceRelationship": {
    "status": "unknown",
    "notes": "Optional bridge between visual identity and broader brand voice. This contract does not replace a dedicated content/voice contract.",
    "traits": [],
    "visualImplications": []
  },
  "applications": {
    "web": {
      "status": "unknown",
      "rules": [],
      "notes": []
    },
    "social": {
      "status": "unknown",
      "rules": [],
      "notes": []
    },
    "print": {
      "status": "unknown",
      "rules": [],
      "notes": []
    },
    "presentation": {
      "status": "unknown",
      "rules": [],
      "notes": []
    },
    "apparel": {
      "status": "not-applicable",
      "rules": [],
      "notes": []
    },
    "embroidery": {
      "status": "not-applicable",
      "rules": [],
      "notes": []
    },
    "engraving": {
      "status": "not-applicable",
      "rules": [],
      "notes": []
    },
    "signage": {
      "status": "not-applicable",
      "rules": [],
      "notes": []
    },
    "other": []
  },
  "creativeAuthority": {
    "locked": [],
    "approved": [],
    "preferred": [],
    "flexible": [],
    "prohibited": [],
    "rule": "Creative systems may interpret flexible areas and may use preferred directions as guidance. They must not alter locked decisions or authoritative assets without explicit human approval."
  },
  "validation": {
    "status": "unknown",
    "tests": [],
    "testShape": {
      "id": "test-id",
      "subject": null,
      "test": "light-background | dark-background | monochrome | solid-color | small-scale | large-scale | no-effects | embroidery | engraving | accessibility | other",
      "result": "pass | conditional | fail | not-tested | not-applicable",
      "notes": [],
      "requiredVariantAssetIds": []
    },
    "handoffTests": [
      {
        "id": "downstream-designer-sufficiency",
        "question": "Could a capable downstream designer who cannot access the original website, brand guide, or discovery conversation still make the important brand-faithful choices from this normalized style guide?",
        "passCondition": "Important authoritative rules, repeated applied-brand patterns, interpretations, provenance, conflicts, and genuine open decisions are preserved with enough specificity to guide design without requiring source rediscovery."
      }
    ]
  },
  "openDecisions": [],
  "openDecisionShape": {
    "id": "unique-open-decision-id",
    "path": "/relevant/contract/path",
    "question": null,
    "status": "unknown | exploring | undecided",
    "context": null,
    "optionsConsidered": [],
    "currentLean": null,
    "suggestedNextStep": null,
    "notes": []
  },
  "continuity": {
    "summary": null,
    "recommendedResumePoint": null,
    "notesForNextAgent": [
      "Do not rediscover or dilute useful applied-brand observations already preserved here. Treat their recorded authority separately from their specificity.",
      "When translating this style guide into components or theme tokens, use locked rules as constraints, approved/preferred observations as guidance, and open decisions as explicit freedom rather than silently inventing brand truth.",
      "Use this style guide as the brand authority for theme building and, normally, alongside a site contract for full site building; do not duplicate its brand rules into the site contract."
    ],
    "rule": "A reasoning agent resuming brand work should preserve established truth, review open decisions, and continue from the recommended resume point rather than restarting discovery."
  },
  "provenance": {
    "createdAt": null,
    "updatedAt": null,
    "createdBy": null,
    "decisionRecords": [],
    "notes": [
      "Important undocumented-but-repeated application patterns should retain provenance to the application/source from which they were observed.",
      "When a current implementation conflicts with authoritative guidance, record the conflict rather than normalizing the implementation into brand truth."
    ]
  }
}