사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/tikalk/adlc-team-skills --skill team-diagnose시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
team-diagnose
Overview
Evidence-first diagnosis of broken adlc-team-skills wiring. The chain has exactly five links, each checkable with one command — a diagnosis without command output is a guess, and guesses get pasted into bug reports.
Boundary: this repo owns .events.json and the boot scripts' output. The injection side (dispatchers, generated per-agent plugins) is owned by adlc-cli — the docs/event-hook-contract.md file in the adlc-team-skills repo draws the line. Diagnose up to it, then route.
When to Use
- Team context missing at session start (no
Team Context & Decisionssection). - A rule that should have matched didn't load.
- Install behaves unexpectedly after an update.
When NOT to use: for application bugs unrelated to the team-context chain, or for skill behavior debates (that's a goldset/eval question).
Core Process
Run the checks in order — stop at the first failure, fix, re-run:
| # | Symptom area | Check (run it) | Green means |
|---|---|---|---|
| 1 | Not configured | cat .adlc/init-options.json | A team_ai_directives path that exists |
| 2 | Missing tool | command -v jq | jq on PATH (skills registry needs it) |
| 3 | Broken handler | bash .agents/skills/team-boot/scripts/boot.sh from the project root | The directives index on stdout, wrapped in EXTREMELY_IMPORTANT |
| 4 | Stale install | pytest tests/unit/test_generated_artifacts_sync.py -q (in the skills repo) or compare skills/**/SKILL.md vs .agents/skills/ names | Mirror matches source |
| 5 | Injection side | Generated plugin present and loaded for the agent? | If 1–4 are green and the session still lacks context → adlc-cli's territory — file there with the outputs of checks 1–4 attached |
For "a rule didn't load" specifically: confirm the session began with the index (check 3's content), then check the task actually matched the rule's descriptor — on-demand pull is match-driven, not mind-reading.
Whole-loop check: scripts/acceptance-test.sh scratch-installs and asserts the chain end-to-end (add --live for a real agent session).
Report format
For a bug report, include: the failing check number, the command, its verbatim output, agent name/version, and how the repo was installed (npx skills add vs adlc-cli). No scrubbed narrative — raw output.
Red Flags
- Concluding before running a command — every check is one command.
- "Reinstall everything" before reading check 3's output.
- Blaming a skill's content when check 1–3 failed (config, not skills).
- Filing injection-side bugs in adlc-team-skills (check 5 routes them).
All of these mean: run the checks, then report.
Verification
A diagnosis is done when:
- [ ] Checks 1–4 each ran with output captured (or 5 routed with evidence)
- [ ] The failing link is named with its command output
- [ ] The report routes to the owning repo
