{"id":50757641,"url":"https://github.com/yumin-chen/policies","last_synced_at":"2026-06-11T06:32:13.289Z","repository":{"id":326414752,"uuid":"1105452785","full_name":"yumin-chen/policies","owner":"yumin-chen","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-28T08:28:33.000Z","size":13696,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-30T08:54:22.211Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yumin-chen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-27T16:20:24.000Z","updated_at":"2025-11-27T16:25:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yumin-chen/policies","commit_stats":null,"previous_names":["yumin-chen/policies"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/yumin-chen/policies","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yumin-chen%2Fpolicies","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yumin-chen%2Fpolicies/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yumin-chen%2Fpolicies/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yumin-chen%2Fpolicies/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yumin-chen","download_url":"https://codeload.github.com/yumin-chen/policies/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yumin-chen%2Fpolicies/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34186385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-11T06:32:12.622Z","updated_at":"2026-06-11T06:32:13.276Z","avatar_url":"https://github.com/yumin-chen.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Principal Decision Documents (PDDs)\n\nThis repository contains **Principal Decision Documents (PDDs)** for organization-wide governance, policies, and rules.  \nIt serves as the **single source of truth** for all cross-project decisions and is designed for discoverability, compliance, and automation.\n\n---\n\n## Table of Contents\n\n- [Purpose](#purpose)  \n- [Repository Structure](#repository-structure)  \n- [Adding or Updating PDDs](#adding-or-updating-pdds)  \n- [Policy Enforcement](#policy-enforcement)  \n- [Governance and Approval](#governance-and-approval)  \n- [Reference \u0026 Links](#reference--links)\n\n---\n\n## Purpose\n\n- Centralize all **org-wide policies** and **principal decisions**.  \n- Ensure **consistency**, **traceability**, and **compliance** across all projects.  \n- Serve as the **source of truth** for automated policy enforcement, including OPA and CI/CD checks.\n\n---\n\n## Repository Structure\n\n```\n\npolicies/\n├── PDD-ADR-VERSIONING.md           # ADR storage \u0026 versioning policy\n├── PDD-SECURITY-GUIDELINES.md      # Security standards and protocols\n├── PDD-CODE-OWNERSHIP.md           # Code ownership and review rules\n└── README.md                       # This documentation\n\n```\n\n- Each PDD is a separate Markdown file.  \n- Metadata headers should include:\n  - `pdd_id`  \n  - `title`  \n  - `status` (Proposed / Active / Approved)  \n  - `authors`  \n  - `date`  \n  - `scope` (Org-wide or specific projects)\n\n---\n\n## Adding or Updating PDDs\n\n1. Create a new Markdown file following the naming convention:  \n   `PDD-\u003cTITLE\u003e.md`  \n\n2. Include **metadata headers** at the top of the file.  \n\n3. Follow the **PDD template**:\n   - Purpose  \n   - Principles  \n   - Enforcement Mechanisms  \n   - Governance  \n   - Rationale  \n\n4. Submit a **pull request** for review and approval.  \n\n5. Upon approval, the PDD is merged and becomes **effective immediately**, unless otherwise stated.\n\n---\n\n## Policy Enforcement\n\n- Automated checks can reference this repository for **OPA policy evaluation**, CI/CD validations, and audit reporting.  \n- Example enforcement includes:  \n  - Validating ADR storage (full + compact Markdown versions)  \n  - Ensuring project compliance with org-wide standards  \n  - Automatic rejection of non-compliant pull requests  \n\n---\n\n## Governance and Approval\n\n- **Decision Authority:** System Architecture Council or equivalent org-wide governance body  \n- **Review Process:** All proposed PDDs must go through formal review and approval via pull request  \n- **Exceptions:** Only allowed via council resolution  \n\n---\n\n## Reference \u0026 Links\n\n- [PDD Template](./TEMPLATE-PDD.md) — For creating new Principal Decision Documents  \n- [OPA Policies](../opa-policies/) — Example Rego policies enforcing PDD rules  \n- [SDLC_IDE ADRs](../adrs/) — Related project-level ADR repository\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyumin-chen%2Fpolicies","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyumin-chen%2Fpolicies","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyumin-chen%2Fpolicies/lists"}