Principled-Evolution · kmadan · Jun 30, 2025
diff --git a/README.md b/README.md
@@ -1,14 +1,6 @@
-# Governance Open Policy Agent Library (_GOPAL_) for AI System Evaluations
+# Gopal - Open Policy Agent Policies for AI Certification
 
-[![OPA Policies CI](https://github.com/Principled-Evolution/gopal/actions/workflows/opa-ci.yaml/badge.svg)](https://github.com/Principled-Evolution/gopal/actions/workflows/opa-ci.yaml)
-[![OPA Version](https://img.shields.io/badge/OPA-Latest-blue.svg)](https://www.openpolicyagent.org/)
-[![Regal Linting](https://img.shields.io/badge/linting-regal-yellow.svg)](https://github.com/StyraInc/regal)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
-
-GOPAL is a collection of [Open Policy Agent (OPA)](https://github.com/open-policy-agent/opa) policies designed for evaluating AI systems against regulatory requirements, compliance standards, and operational criteria. It serves as the policy engine for [AICertify](https://github.com/principled-evolution/aicertify) but can also be used independently with other OPA-based systems.
-
-<img src="https://www.mermaidchart.com/raw/3a013c43-9ae3-4194-8bba-86b17004c800?theme=light&version=v0.1&format=svg" alt="Mermaid Chart" width="500" height="400">
+Gopal is a collection of Open Policy Agent (OPA) policies designed for evaluating AI systems against regulatory requirements, compliance standards, and operational criteria. It serves as the policy engine for [AICertify](https://github.com/mantric/aicertify) but can also be used independently with other OPA-based systems.
 
 ## Directory Structure
 
@@ -29,7 +21,7 @@ gopal/
 │   ├── aiops/            # AI Operations policies
 │   ├── cost/             # Cost management policies
 │   └── corporate/        # Corporate internal policies
-├── custom/               # Custom policy categories (local only, excluded from PRs)
+├── custom/               # Custom policy categories
 └── helper_functions/     # Shared utility functions for policies
 ```
 
@@ -41,7 +33,7 @@ Policies are organized in a modular structure to allow for clear separation of c
 2. **International Policies**: Requirements from specific regulatory frameworks
 3. **Industry-Specific Policies**: Requirements specific to industry verticals
 4. **Operational Policies**: Requirements related to operational aspects
-5. **Custom Policies**: User-defined policy categories (local development only)
+5. **Custom Policies**: User-defined policy categories
 
 ## Versioning
 
@@ -52,77 +44,15 @@ Each policy category uses versioned directories (e.g., `v1/`) to support evoluti
 
 ## Integration with AICertify
 
-Gopal is designed to work seamlessly with [AICertify](https://github.com/principled-evolution/aicertify), a framework for systematically evaluating AI systems against regulatory requirements. When used with AICertify, Gopal provides the policy rules that determine compliance status.
+Gopal is designed to work seamlessly with [AICertify](https://github.com/mantric/aicertify), a framework for systematically evaluating AI systems against regulatory requirements. When used with AICertify, Gopal provides the policy rules that determine compliance status.
 
 ## Standalone Usage
 
 Gopal can also be used independently with any OPA-compatible system. The policies follow standard OPA patterns and can be evaluated using the OPA CLI or API.
 
-## Custom Policies
-
-The `custom/` directory is provided for local development of organization-specific policies. This directory is:
-
-- **Excluded from git tracking** - Custom policies are not included in commits or PRs to the origin repository
-- **Ignored by CI/CD** - Custom policies do not affect the build or linting processes
-- **Local development only** - Allows organizations to develop proprietary policies alongside the standard GOPAL policies
-
-To create custom policies:
-
-1. Create your policy structure under `custom/your_category/v1/`
-2. Follow the same naming conventions as standard policies
-3. Use the package name `custom.your_category.v1.policy_name`
-4. Include comprehensive tests and documentation
-
-Example structure:
-```
-custom/
-├── my_org/
-│   ├── v1/
-│   │   ├── compliance/
-│   │   │   ├── policy.rego
-│   │   │   └── policy_test.rego
-│   │   └── security/
-│   │       ├── policy.rego
-│   │       └── policy_test.rego
-```
-
-**Note**: Custom policies remain local to your development environment and are not shared with the broader GOPAL community.
-
-## Development
-
-### Pre-commit Hooks
-
-This repository includes pre-commit hooks to ensure code quality. The hooks run:
-
-1. Basic file checks (trailing whitespace, end-of-file, etc.)
-2. OPA check (`opa check .`)
-3. Regal lint (`regal lint .`)
-
-To use the pre-commit hooks locally, install pre-commit, OPA, and Regal, then run:
-
-```bash
-# Install pre-commit
-pip install pre-commit
-
-# Install OPA
-curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_linux_amd64
-chmod 755 opa
-sudo mv opa /usr/local/bin/
-
-# Install Regal
-curl -L -o regal https://github.com/StyraInc/regal/releases/latest/download/regal_Linux_x86_64
-chmod +x regal
-sudo mv regal /usr/local/bin/
-
-# Install the pre-commit hooks
-pre-commit install
-```
-
-## Related Projects
+## FAQ
 
-- [Open Policy Agent (OPA)](https://github.com/open-policy-agent/opa) - The policy engine that powers GOPAL
-- [Regal](https://github.com/StyraInc/regal) - A linter for Rego, the policy language used by OPA
-- [AICertify](https://github.com/principled-evolution/aicertify) - A framework for systematically evaluating AI systems against regulatory requirements
+For frequently asked questions about using Gopal, writing policies, and integration patterns, see our [FAQ documentation](docs/FAQ.md).
 
 ## License