Skip to content

Author

A ProblemSpec JSON is the entire input to Squeaky Clean. Everything in this section helps you write one that produces the architecture you intended.

  • Your first ProblemSpec — minimum viable spec, best practices, anti-patterns, worked examples.
  • Domain conventions — encode common semantics (timeline_includes_self, follow_asymmetric) so the architect stops re-deriving them.
  • Data classification — sensitivity tags for credentials and PII; couple to SecurityArchitect output.
  • Cross-service contractsproduces_contracts / consumes_contracts for distributed systems.