{"owner":"tektoncd","repo":"pipeline","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Agent notes for Tekton Pipelines\n\nIf you're an agent working in this repo, start here. This file is meant to orient you quickly; it does not replace the project docs or maintainer judgment.\n\n## Ground rules\n\n- These notes apply to the whole repo.\n- Do not add more `AGENTS.md` files unless a maintainer asks.\n- Keep changes narrow and easy to review.\n- Prefer the smallest test that proves the change.\n- Do not hand-edit generated files or `vendor/`; use the matching update script or dependency workflow.\n- When in doubt, follow nearby code and ask before inventing a new pattern.\n\n## Repo shape\n\n- `cmd/`: binaries such as controller, webhook, entrypoint, resolver, and events.\n- `pkg/apis/`: API types, defaults, validation, conversion, and generated clients.\n- `pkg/reconciler/`: TaskRun, PipelineRun, CustomRun, resolver, event, and notification reconcilers.\n- `pkg/pod`, `pkg/workspace`, `pkg/substitution`: helpers used by the reconcilers.\n- `internal/`: private implementation packages; prefer this for new non-API helpers.\n- `config/`: install manifests and CRDs. Many files here are generated.\n- `test/`: e2e tests, conformance tests, helpers, and presubmit scripts.\n- `docs/`: user-facing and developer documentation.\n\n## Before changing code\n\n- Read `CONTRIBUTING.md`, `DEVELOPMENT.md`, `test/README.md`, and the docs for the area you are touching.\n- When opening PRs, follow the repo's PR template in `.github/pull_request_template.md`.\n- For API changes, read `api_compatibility_policy.md` first and expect codegen/OpenAPI updates.\n- For reconciler changes, add or update package tests with fake clients before reaching for e2e tests.\n- For e2e changes, follow the annotations and categories in `test/README.md`.\n\n## Useful checks\n\n- Format Go: `gofmt -w <files>`.\n- Test one package: `go test ./path/to/package`.\n- Test one case: `go test ./path/to/package -run TestName`.\n- Run common packages: `go test ./pkg/...`.\n- Run generated-code check: `./hack/verify-codegen.sh`.\n- Update generated code when needed: `./hack/update-codegen.sh`.\n- Run the local agent-context check: `./hack/verify-agent-readiness.sh`.\n\n## More context\n\n- Repo map for agents: `docs/agents/agent-context.md`.\n- Discovery skill: `skills/tekton-pipeline-discovery/SKILL.md`.\n- Skill discovery symlinks live under `.agents/`, `.claude/`, `.codex/`, and `.cursor/`.\n"},"files":{"AGENTS.md":"# Agent notes for Tekton Pipelines\n\nIf you're an agent working in this repo, start here. This file is meant to orient you quickly; it does not replace the project docs or maintainer judgment.\n\n## Ground rules\n\n- These notes apply to the whole repo.\n- Do not add more `AGENTS.md` files unless a maintainer asks.\n- Keep changes narrow and easy to review.\n- Prefer the smallest test that proves the change.\n- Do not hand-edit generated files or `vendor/`; use the matching update script or dependency workflow.\n- When in doubt, follow nearby code and ask before inventing a new pattern.\n\n## Repo shape\n\n- `cmd/`: binaries such as controller, webhook, entrypoint, resolver, and events.\n- `pkg/apis/`: API types, defaults, validation, conversion, and generated clients.\n- `pkg/reconciler/`: TaskRun, PipelineRun, CustomRun, resolver, event, and notification reconcilers.\n- `pkg/pod`, `pkg/workspace`, `pkg/substitution`: helpers used by the reconcilers.\n- `internal/`: private implementation packages; prefer this for new non-API helpers.\n- `config/`: install manifests and CRDs. Many files here are generated.\n- `test/`: e2e tests, conformance tests, helpers, and presubmit scripts.\n- `docs/`: user-facing and developer documentation.\n\n## Before changing code\n\n- Read `CONTRIBUTING.md`, `DEVELOPMENT.md`, `test/README.md`, and the docs for the area you are touching.\n- When opening PRs, follow the repo's PR template in `.github/pull_request_template.md`.\n- For API changes, read `api_compatibility_policy.md` first and expect codegen/OpenAPI updates.\n- For reconciler changes, add or update package tests with fake clients before reaching for e2e tests.\n- For e2e changes, follow the annotations and categories in `test/README.md`.\n\n## Useful checks\n\n- Format Go: `gofmt -w <files>`.\n- Test one package: `go test ./path/to/package`.\n- Test one case: `go test ./path/to/package -run TestName`.\n- Run common packages: `go test ./pkg/...`.\n- Run generated-code check: `./hack/verify-codegen.sh`.\n- Update generated code when needed: `./hack/update-codegen.sh`.\n- Run the local agent-context check: `./hack/verify-agent-readiness.sh`.\n\n## More context\n\n- Repo map for agents: `docs/agents/agent-context.md`.\n- Discovery skill: `skills/tekton-pipeline-discovery/SKILL.md`.\n- Skill discovery symlinks live under `.agents/`, `.claude/`, `.codex/`, and `.cursor/`.\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Agent notes for Tekton Pipelines\n\nIf you're an agent working in this repo, start here. This file is meant to orient you quickly; it does not replace the project docs or maintainer judgment.\n\n## Ground rules\n\n- These notes apply to the whole repo.\n- Do not add more `AGENTS.md` files unless a maintainer asks.\n- Keep changes narrow and easy to review.\n- Prefer the smallest test that proves the change.\n- Do not hand-edit generated files or `vendor/`; use the matching update script or dependency workflow.\n- When in doubt, follow nearby code and ask before inventing a new pattern.\n\n## Repo shape\n\n- `cmd/`: binaries such as controller, webhook, entrypoint, resolver, and events.\n- `pkg/apis/`: API types, defaults, validation, conversion, and generated clients.\n- `pkg/reconciler/`: TaskRun, PipelineRun, CustomRun, resolver, event, and notification reconcilers.\n- `pkg/pod`, `pkg/workspace`, `pkg/substitution`: helpers used by the reconcilers.\n- `internal/`: private implementation packages; prefer this for new non-API helpers.\n- `config/`: install manifests and CRDs. Many files here are generated.\n- `test/`: e2e tests, conformance tests, helpers, and presubmit scripts.\n- `docs/`: user-facing and developer documentation.\n\n## Before changing code\n\n- Read `CONTRIBUTING.md`, `DEVELOPMENT.md`, `test/README.md`, and the docs for the area you are touching.\n- When opening PRs, follow the repo's PR template in `.github/pull_request_template.md`.\n- For API changes, read `api_compatibility_policy.md` first and expect codegen/OpenAPI updates.\n- For reconciler changes, add or update package tests with fake clients before reaching for e2e tests.\n- For e2e changes, follow the annotations and categories in `test/README.md`.\n\n## Useful checks\n\n- Format Go: `gofmt -w <files>`.\n- Test one package: `go test ./path/to/package`.\n- Test one case: `go test ./path/to/package -run TestName`.\n- Run common packages: `go test ./pkg/...`.\n- Run generated-code check: `./hack/verify-codegen.sh`.\n- Update generated code when needed: `./hack/update-codegen.sh`.\n- Run the local agent-context check: `./hack/verify-agent-readiness.sh`.\n\n## More context\n\n- Repo map for agents: `docs/agents/agent-context.md`.\n- Discovery skill: `skills/tekton-pipeline-discovery/SKILL.md`.\n- Skill discovery symlinks live under `.agents/`, `.claude/`, `.codex/`, and `.cursor/`.\n","category":"root","tokens":589}]}