|
| 1 | +# CLAUDE.md |
| 2 | + |
| 3 | +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. |
| 4 | + |
| 5 | +## Repository Overview |
| 6 | + |
| 7 | +This is the governance repository for the **OpenSSF Technical Advisory Council (TAC)** — the body overseeing all Technical Initiatives (TIs) within the Open Source Security Foundation. It contains no application code; it is entirely documentation, governance processes, and meeting records in Markdown. |
| 8 | + |
| 9 | +## Repository Structure |
| 10 | + |
| 11 | +- `process/` — Core governance docs: TI lifecycle stages (Sandbox → Incubating → Graduated), decision processes, roles & responsibilities, funding requests, and stage-specific requirements in subdirectories |
| 12 | +- `TI-reports/` — Quarterly status update reports from Technical Initiatives (use `0000-quarterly-update-template.md` as a template) |
| 13 | +- `minutes/` — TAC meeting minutes (chronological, dating back to 2020) |
| 14 | +- `elections/` — TAC and SCIR election nominations and results |
| 15 | +- `policies/` — Governance policies (e.g., access control) |
| 16 | +- `files/images/` — Image assets referenced by documentation |
| 17 | +- `organizational-structure-overview.md` — Org hierarchy and project-to-WG mapping |
| 18 | +- `technical-vision.md` — 2-5 year strategic vision |
| 19 | +- `working-group-abilities.md` — Permitted WG activities and autonomy |
| 20 | + |
| 21 | +## Key Governance Concepts |
| 22 | + |
| 23 | +The TI lifecycle has three stages: **Sandbox → Incubating → Graduated**. Requirements for each stage differ by TI type (Working Group, Project, SIG) and are documented in `process/wg-lifecycle-documents/`, `process/project-lifecycle-documents/`, and `process/sig-lifecycle.md`. |
| 24 | + |
| 25 | +The main README.md contains the canonical table of all TIs with their current lifecycle status, sponsoring WG, and repository links. |
| 26 | + |
| 27 | +## Contribution Requirements |
| 28 | + |
| 29 | +- **DCO required**: All commits must include a `Signed-off-by` line. Use `git commit -s` to add it automatically. |
| 30 | +- **GitVote**: Decisions use `.gitvote.yml` — 2-week voting period, 55% pass threshold, voters are `@ossf/tac` team members. |
| 31 | +- **CODEOWNERS**: Repository is owned by `@ossf/tac`. |
| 32 | + |
| 33 | +## Common Tasks |
| 34 | + |
| 35 | +- **Adding a quarterly report**: Create a new file in `TI-reports/` following the template in `TI-reports/0000-quarterly-update-template.md` |
| 36 | +- **Updating TI status**: Edit the tables in `README.md` to reflect lifecycle stage changes |
| 37 | +- **Adding meeting minutes**: Create a new dated file in `minutes/` |
0 commit comments