docs: add DIP quickstart and developer guide

Author: pavancharak

docs/developer/DIP_DEVELOPER_GUIDE.md

@@ -0,0 +1,130 @@
+\# DIP Developer Guide
+
+
+
+This guide explains how developers can integrate the
+
+Decision Integrity Protocol into automated systems.
+
+
+
+---
+
+
+
+\# Decision Workflow
+
+
+
+Typical system integration:
+
+
+
+
+
+application
+
+↓
+
+decision.json
+
+↓
+
+dip sign
+
+↓
+
+artifact.json
+
+↓
+
+dip proof
+
+↓
+
+proof.json
+
+
+
+
+
+---
+
+
+
+\# Integration Pattern
+
+
+
+Applications generate decision records
+
+and pass them to the DIP CLI.
+
+
+
+Example workflow:
+
+
+
+1 Generate decision record
+
+2 Sign the decision
+
+3 Append artifact to registry
+
+4 Generate proof
+
+5 Store bundle
+
+
+
+---
+
+
+
+\# Verification
+
+
+
+Verification can occur in any environment.
+
+
+
+The verifier requires only:
+
+
+
+
+
+artifact
+
+proof
+
+verifier
+
+
+
+
+
+---
+
+
+
+\# Example Use Cases
+
+
+
+Infrastructure deployment verification
+
+
+
+Automated policy enforcement
+
+
+
+Access control decision tracking
+
+
+
+Financial decision auditing
+

docs/developer/DIP_QUICKSTART.md

@@ -0,0 +1,130 @@
+\# DIP Quickstart
+
+
+
+This guide shows how to create and verify a decision artifact
+
+using the Decision Integrity Protocol.
+
+
+
+\## 1 Create a Decision Record
+
+
+
+Create a file named `decision.json`.
+
+
+
+Example:
+
+
+
+```json
+
+{
+
+  "decision\_id": "deploy-001",
+
+  "timestamp": "2026-03-07T10:00:00Z",
+
+  "inputs": {
+
+    "environment": "production"
+
+  },
+
+  "outputs": {
+
+    "approved": true
+
+  }
+
+}
+
+2 Generate an Artifact
+
+
+
+Run:
+
+
+
+dip sign decision.json
+
+
+
+Output:
+
+
+
+artifact.json
+
+3 Generate a Proof
+
+
+
+Run:
+
+
+
+dip proof artifact.json
+
+
+
+Output:
+
+
+
+proof.json
+
+4 Create a Bundle
+
+
+
+Run:
+
+
+
+dip bundle artifact.json proof.json
+
+
+
+Output:
+
+
+
+decision.dip
+
+5 Verify the Artifact
+
+
+
+Run:
+
+
+
+dip verify decision.dip
+
+
+
+Output:
+
+
+
+DIP bundle verification: VALID
+
+Protocol Guarantee
+
+
+
+Verification requires only:
+
+
+
+artifact + proof + verifier = truth
+
+
+
+No access to the original system is required.
+