feat: add interactive policy builder to docs

config/navigation.json

@@ -439,6 +439,7 @@
               "group": "Policies",
               "pages": [
                 "policy-reference/environment_policy",
+                "policy-reference/policy_builder",
                 "policy-reference/rego_policy"
               ]
             }

policy-reference/environment_policy.mdx

@@ -5,6 +5,10 @@ description: "Reference for the YAML policy files used to define compliance requ
 
 An environment policy is a YAML file that declares compliance requirements for artifacts running in a Kosli environment. You pass the file to [`kosli create policy`](/client_reference/kosli_create_policy) to create or update a policy. For concepts, workflow, and enforcement, see [Environment Policies](/getting_started/policies).
 
+<Tip>
+  Prefer to build a policy interactively? Use the [Policy builder](/policy-reference/policy_builder) to assemble a valid policy file in your browser and copy the YAML.
+</Tip>
+
 ## Specification
 
 <ParamField path="_schema" type="string" required>
@@ -190,6 +194,7 @@ _schema: https://docs.kosli.com/schemas/policy/v1
 
 ## See also
 
+- [Policy builder](/policy-reference/policy_builder) — build a policy file interactively in the browser
 - [Environment Policies](/getting_started/policies) — concepts, workflow, and enforcement
 - [`kosli create policy`](/client_reference/kosli_create_policy) — create or update a policy
 - [`kosli attach-policy`](/client_reference/kosli_attach-policy) — attach a policy to an environment

policy-reference/policy_builder.mdx

@@ -0,0 +1,24 @@
+---
+title: "Environment Policy Builder"
+description: "Build a Kosli environment policy YAML interactively in the browser and copy the result into your repo."
+mode: "wide"
+---
+
+import { PolicyBuilder } from "/snippets/policy-builder.jsx";
+
+Use this builder to assemble an [environment policy](/policy-reference/environment_policy). Toggle the requirements you need, add attestation rules and exceptions, then copy the generated YAML into a file in your repo.
+
+The output conforms to the [v1 policy schema](https://docs.kosli.com/schemas/policy/v1.json) and runs entirely in your browser — nothing is sent to Kosli.
+
+<PolicyBuilder />
+
+## Next steps
+
+- Save the YAML as a file (e.g. `policy.yaml`) in your repo.
+- Create or update the policy with [`kosli create policy`](/client_reference/kosli_create_policy).
+- Attach it to an environment with [`kosli attach-policy`](/client_reference/kosli_attach-policy).
+
+## See also
+
+- [Environment Policy](/policy-reference/environment_policy) — full schema reference and field descriptions
+- [Environment Policies](/getting_started/policies) — concepts, workflow, and enforcement