메뉴
Use when needing to understand Konflux architecture, design decisions, service responsibilities, APIs, build/test/release workflows, or how Konflux components fit together.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | konflux-architecture |
| description | Use when needing to understand Konflux architecture, design decisions, service responsibilities, APIs, build/test/release workflows, or how Konflux components fit together. |
| allowed-tools | Bash(git clone:*), Bash(git pull:*), Bash(find:*), Bash(ls:*), Bash(grep:*), Bash(cat:*), Read, Glob, Grep |
Two GitHub repositories are the canonical source of truth for Konflux architecture. Clone them and read the actual content - do not answer architecture questions from memory or training data alone.
| Repository | Clone To | Contains |
|---|---|---|
| konflux-ci/architecture | /tmp/konflux-architecture | ADRs, service specs, design diagrams, architectural constraints |
| konflux-ci/docs | /tmp/konflux-docs | User-facing guides (AsciiDoc/Antora), API references, troubleshooting |
Always clone and read. Do not describe directory layouts from memory - fetch the actual content.
# Clone or pull to ensure fresh content
if [ -d /tmp/konflux-architecture ]; then git -C /tmp/konflux-architecture pull --ff-only; else git clone https://github.com/konflux-ci/architecture /tmp/konflux-architecture; fi
if [ -d /tmp/konflux-docs ]; then git -C /tmp/konflux-docs pull --ff-only; else git clone https://github.com/konflux-ci/docs /tmp/konflux-docs; fi
Then navigate from broad to specific:
Step 1 - Orient. Read the overview to identify which services are relevant:
/tmp/konflux-architecture/architecture/index.mdarchitecture/core/ (build-service, integration-service, release-service, pipeline-service, enterprise-contract, hybrid-application-service, konflux-ui)architecture/add-ons/ (image-controller, mintmaker, multi-platform-controller, etc.)Step 2 - Read the relevant service doc:
/tmp/konflux-architecture/architecture/core/<service-name>.mdStep 3 - Search ADRs for design rationale:
# Find ADRs related to your topic
grep -ril "your-topic" /tmp/konflux-architecture/ADR/
# Then read the matching ADRs
ADR/NNNN-description.mdStep 4 - Get user-facing details from the docs repo:
# Find relevant docs pages
grep -ril "your-topic" /tmp/konflux-docs/modules/
modules/building/, modules/testing/, modules/releasing/modules/troubleshooting/, modules/patterns/, modules/reference/Before evaluating a proposed feature, actually read these sources:
| Mistake | Better Approach |
|---|---|
| Describing repos without reading them | Clone and read the actual files |
| Answering from training data | Fetch current content - repos evolve |
| Proposing features without checking ADRs | grep -ril "topic" /tmp/konflux-architecture/ADR/ first |
| Reading only one repo | Design repo + docs repo together give the full picture |
| Reading everything upfront | Start with overview, then drill into relevant service docs only |
Use when needing to know which Red Hat team owns a Konflux-related repository (konflux-ci, hermetoproject, conforma orgs), which JIRA project or component to file issues against, or how the Red Hat Konflux engineering organization maps to the codebase.
Use when updating a Maven project to source its dependencies from a trusted Maven repository instead of Maven Central.
Use to trigger component builds, releases or get a component or application status
Use when tracing Konflux builds from image references, finding build logs from artifacts, or verifying source commits for container images - extracts provenance attestations to navigate from images back to builds and source code
Use when GitHub PR or branch has failing checks and you need to find Konflux pipeline information (cluster, namespace, PipelineRun name). Teaches gh CLI commands to identify Konflux checks (filter out Prow/SonarCloud), extract PipelineRun URLs from builds and integration tests, and parse URLs for kubectl debugging.
Use when Konflux pipelines fail, are stuck, timeout, or show errors like ImagePullBackOff. Covers PipelineRun failures, TaskRun issues (Pending, Failed, stuck Running), build errors, and systematic debugging of Tekton pipeline problems using kubectl and logs.