OverviewFilesCommitsIssuesDocsReleasesPeers

knowledge-ratchet / data / principles.json

175 lines · json ref:
[
  {
    "principle": "Verify before acting — understand the full system, confirm state, never assume.",
    "coveredPatterns": [
      "verification"
    ],
    "strength": "high",
    "supportingFacts": [
      "always-test-7rnx",
      "blender-api-verify",
      "browse-for-federation",
      "bump-addon-version",
      "commit-every-change",
      "dont-assume-background-process-worked",
      "exact-repro",
      "fix-deploy-path",
      "godot-cw-winding",
      "incremental-testing",
      "nested-repo-commits",
      "never-assume-investigate",
      "never-bypass-systems",
      "never-change-pgh-server",
      "never-delete-storage",
      "no-kludge-fixes",
      "pear-git-dev-discipline",
      "pear-git-server-never-restart",
      "stale-launchers",
      "step-back-when-messy",
      "stortron-sidecar",
      "test-before-more-code",
      "verify-binary-matches-source"
    ],
    "factCount": 23,
    "validatedAt": "2026-04-07T03:11:31.384Z",
    "contradictions": [],
    "overrideCount": 0,
    "status": "active"
  },
  {
    "principle": "Use established tools and paths. Never invent ad-hoc alternatives for deployment.",
    "coveredPatterns": [
      "deployment"
    ],
    "strength": "high",
    "supportingFacts": [
      "always-test-7rnx",
      "blender-api-verify",
      "browse-for-federation",
      "commit-every-change",
      "exact-repro",
      "fix-deploy-path",
      "godot-cw-winding",
      "hyperdrive-cleanup",
      "hypernote-ssr-lessons",
      "incremental-testing",
      "nested-repo-commits",
      "never-assume-investigate",
      "never-bypass-systems",
      "never-change-pgh-server",
      "never-delete-storage",
      "never-run-destructive-identity-ops",
      "no-kludge-fixes",
      "pear-git-dev-discipline",
      "pear-git-server-never-restart",
      "stale-launchers",
      "step-back-when-messy",
      "stortron-sidecar",
      "test-before-more-code",
      "understand-before-editing",
      "use-service-scripts"
    ],
    "factCount": 25,
    "validatedAt": "2026-04-07T03:11:31.384Z",
    "contradictions": [],
    "overrideCount": 0,
    "status": "active"
  },
  {
    "principle": "When something breaks, fix the system — never work around it. One change, one verify, one commit.",
    "coveredPatterns": [
      "discipline"
    ],
    "strength": "high",
    "supportingFacts": [
      "always-test-7rnx",
      "blender-api-verify",
      "bump-addon-version",
      "commit-every-change",
      "exact-repro",
      "fix-deploy-path",
      "fix-dont-skip",
      "godot-cw-winding",
      "hypernote-ssr-lessons",
      "incremental-testing",
      "nested-repo-commits",
      "never-bypass-systems",
      "never-change-pgh-server",
      "never-delete-storage",
      "never-run-destructive-identity-ops",
      "no-apologies",
      "no-kludge-fixes",
      "pear-git-dev-discipline",
      "pear-git-server-never-restart",
      "step-back-when-messy",
      "stortron-sidecar",
      "test-before-more-code",
      "understand-before-editing",
      "use-service-scripts",
      "verify-binary-matches-source"
    ],
    "factCount": 25,
    "validatedAt": "2026-04-07T03:11:31.384Z",
    "contradictions": [],
    "overrideCount": 0,
    "status": "active"
  },
  {
    "principle": "Understand the full system before modifying any part. Research APIs, check downstream impact.",
    "coveredPatterns": [
      "system-knowledge"
    ],
    "strength": "medium",
    "supportingFacts": [
      "always-test-7rnx",
      "blender-api-verify",
      "browse-for-federation",
      "bump-addon-version",
      "dont-assume-background-process-worked",
      "exact-repro",
      "godot-cw-winding",
      "hyperdrive-cleanup",
      "hypernote-ssr-lessons",
      "nested-repo-commits",
      "never-assume-investigate",
      "never-change-pgh-server",
      "never-delete-storage",
      "pear-git-dev-discipline",
      "pear-git-server-never-restart",
      "stale-launchers",
      "step-back-when-messy",
      "stortron-sidecar",
      "understand-before-editing",
      "use-service-scripts",
      "verify-binary-matches-source"
    ],
    "factCount": 21,
    "validatedAt": "2026-04-07T03:11:31.384Z",
    "contradictions": [],
    "overrideCount": 0,
    "status": "active"
  },
  {
    "principle": "Never destroy persistent state. Every storage decision must answer: what is the deletion story?",
    "coveredPatterns": [
      "persistence"
    ],
    "strength": "high",
    "supportingFacts": [
      "browse-for-federation",
      "hyperdrive-cleanup",
      "hypernote-ssr-lessons",
      "nested-repo-commits",
      "never-assume-investigate",
      "never-delete-storage",
      "never-run-destructive-identity-ops",
      "pear-git-dev-discipline",
      "verify-binary-matches-source"
    ],
    "factCount": 9,
    "validatedAt": "2026-04-07T03:11:31.384Z",
    "contradictions": [],
    "overrideCount": 0,
    "status": "active"
  }
]