chore: 이전 세션이 남긴 변경을 커밋한다
이번 파이프라인 작업과 무관하게 작업 트리에 남아 있던 것을 그대로 올린다. 사용자가 「전부 커밋」으로 정했고, 이번 작업과 섞이지 않게 커밋만 나눴다. 대부분은 clean-architecture-backend-template 의 그림 정본 재배치다 — final/assets/diagrams/<이름>/ 에 있던 것이 CLAUDE.md 가 적은 배치인 final/assets/<이름>/ 로 옮겨졌고 .techviz/<이름>/ 이 함께 들어왔다. 삽입 줄의 대부분(3.15M)이 그 .techviz context.json 이다. 그 밖에 ca-tmpl·document-haness 의 정리, .claude/agents/ 열한 개, writing-practitioner-guides 스킬, .playwright-mcp 세션 산출물, scripts/check-ssot-facts.py 와 그 시험이 들어 있다. 이 커밋의 내용은 내가 만든 것이 아니라 이전 세션이 남긴 것이고 검증하지 않았다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
co-authored by
Claude Opus 5
Claude Opus 5
parent
2109f726fe
commit
ab59130196
@@ -43,6 +43,31 @@ REQUIRED_PATHS = (
|
||||
".agents/skills/writing-as-the-person-who-did-it/scripts/check_voice.mjs",
|
||||
".agents/skills/technical-visualizer/SKILL.md",
|
||||
".agents/skills/refactoring-from-analysis/SKILL.md",
|
||||
# 환경 구성(SETUP) 본문의 명령 형태를 정한다. writing-tech-log-records 가 아홉 곳에서
|
||||
# 이 스킬을 열라고 시키므로 저장소 안에 있어야 한다 — 전역에만 두면 클론한 사람에게는 없다
|
||||
".agents/skills/writing-practitioner-guides/SKILL.md",
|
||||
".agents/skills/writing-practitioner-guides/references/kubernetes.md",
|
||||
".agents/skills/writing-practitioner-guides/references/linux-systemd.md",
|
||||
".agents/skills/writing-practitioner-guides/references/networking-tls.md",
|
||||
".agents/skills/writing-practitioner-guides/references/datastores.md",
|
||||
# 역할이 나뉜 서브에이전트. 한 세션이 쓰기와 검증을 겸하면 자동 검사가 전부 통과한
|
||||
# 상태로 사실 오류가 새어 나간다 — 실제로 그렇게 새어 나간 것이 이 저장소에 있었다.
|
||||
#
|
||||
# 앞의 다섯은 파이프라인 S1·S2·S4·S5·S6 을 맡는다. 없으면 그 단계가 매번 새로 띄운
|
||||
# 일반 에이전트로 돌고, 그러면 어떤 규칙으로 일했는지가 어디에도 안 남는다 —
|
||||
# 원장의 `runBy` 가 `"subagent"` 라는 상수였던 것이 그 상태였다.
|
||||
".claude/agents/ssot-analyst.md",
|
||||
".claude/agents/tree-deriver.md",
|
||||
".claude/agents/diagram-maker.md",
|
||||
".claude/agents/prose-rewriter.md",
|
||||
".claude/agents/voice-writer.md",
|
||||
# 뒤의 여섯은 기록 한 편을 쓰고 검증하는 역할이다. S3·S7 이 여기에 걸린다
|
||||
".claude/agents/source-auditor.md",
|
||||
".claude/agents/record-writer.md",
|
||||
".claude/agents/fact-reviewer.md",
|
||||
".claude/agents/reader-reviewer.md",
|
||||
".claude/agents/setup-runner.md",
|
||||
".claude/agents/studio-validator.md",
|
||||
# 프로젝트 폴더 틀 — 끝난 프로젝트의 모양. 작업 재료는 여기 없다
|
||||
"docs/_templates/README.md",
|
||||
"docs/_templates/final/document.md",
|
||||
@@ -58,6 +83,8 @@ REQUIRED_PATHS = (
|
||||
".agents/skills/writing-tech-log-records/templates/reference.md",
|
||||
".agents/skills/writing-tech-log-records/templates/question.md",
|
||||
".agents/skills/writing-tech-log-records/templates/decision.md",
|
||||
# 여섯 번째 종류. 이 목록도 손으로 나열하는 자리라 종류를 더할 때 함께 채운다
|
||||
".agents/skills/writing-tech-log-records/templates/setup.md",
|
||||
# 도구
|
||||
"scripts/techviz",
|
||||
"scripts/build-tech-log-tree.py",
|
||||
@@ -282,6 +309,9 @@ class _OutputReport:
|
||||
def error(self, rule: str, detail: str = "") -> None:
|
||||
self.errors.setdefault(rule, []).append(detail)
|
||||
|
||||
def warn(self, rule: str, detail: str = "") -> None:
|
||||
self.warns.setdefault(rule, []).append(detail)
|
||||
|
||||
@property
|
||||
def error_count(self) -> int:
|
||||
return sum(len(v) for v in self.errors.values())
|
||||
@@ -307,6 +337,11 @@ OUTPUT_CHECKS = (
|
||||
("check-required-content",
|
||||
lambda root, proj: [sys.executable,
|
||||
str(root / "scripts" / "check-required-content.py"), proj]),
|
||||
# 넷째 `check-ssot-facts.py`. 앞의 셋은 **기록**이 SSOT 와 어긋나지 않는지를 보고,
|
||||
# 이것은 그 위 — SSOT 자신이 코드베이스와 맞는지를 본다 (계획서 §6).
|
||||
("check-ssot-facts",
|
||||
lambda root, proj: [sys.executable,
|
||||
str(root / "scripts" / "check-ssot-facts.py"), proj]),
|
||||
)
|
||||
|
||||
|
||||
@@ -320,7 +355,7 @@ def _last_meaningful_line(text: str) -> str:
|
||||
def verify_outputs(shared_root: Path) -> list:
|
||||
"""산출물 검사 셋을 프로젝트마다 돌린다.
|
||||
|
||||
종료 코드를 그대로 읽는다. **0 이 아니면 error 다** — `ca-tmpl` 처럼 계약 파일이 없어
|
||||
종료 코드를 그대로 읽는다. **0 이 아니면 error 다** — 계약 파일(`tech-log-tree.json`)이 없어
|
||||
나는 exit 2 도 포함한다. 「대상 없음」으로 넘기면 계약을 채택하지 않은 프로젝트가
|
||||
검사를 피한다. `verify-tech-log-tree.py` 는 `tech-log-studio/` 가 없는 프로젝트를
|
||||
아예 목록에 넣지 않으므로 지금은 그 상태를 아무도 세지 않는다.
|
||||
@@ -359,6 +394,47 @@ def verify_runs(shared_root: Path):
|
||||
return [module.verify(str(p)) for p in ledgers]
|
||||
|
||||
|
||||
def verify_run_coverage(shared_root: Path):
|
||||
"""기록 한 편에 런 원장 하나가 붙어 있나.
|
||||
|
||||
원장의 `record` 칸이 그 런이 만든 기록을 가리킨다. 기록은 47편인데 원장이 1개면
|
||||
**나머지 46편은 어느 절차로 나왔는지 이 저장소가 모른다.** 검사기가 그것을 세지
|
||||
않으면 「원장이 전부 통과」가 「전부 원장을 지났다」로 읽힌다.
|
||||
|
||||
**없는 것은 error 가 아니다.** 파이프라인을 거치지 않고 손으로 쓴 기록이 있는 것
|
||||
자체는 잘못이 아니고, 지나간 일에 원장을 소급해 만드는 것은 영수증 위조다. 다만
|
||||
**초록으로 보이면 안 된다** — warn 으로 세고 요약 줄이 덮인 편수를 적는다.
|
||||
"""
|
||||
reports = []
|
||||
for project_dir in sorted((shared_root / "docs").glob("*/tech-log-studio")):
|
||||
project = project_dir.parent.name
|
||||
records = {
|
||||
str(p.relative_to(shared_root))
|
||||
for p in project_dir.rglob("*.md")
|
||||
}
|
||||
if not records:
|
||||
continue
|
||||
covered: set[str] = set()
|
||||
for ledger in sorted((shared_root / "runs" / project).glob("*/run.json")):
|
||||
try:
|
||||
rec = json.loads(ledger.read_text(encoding="utf-8")).get("record")
|
||||
except (OSError, ValueError):
|
||||
continue
|
||||
if not rec:
|
||||
continue
|
||||
rec = str(rec).strip()
|
||||
if rec in records:
|
||||
covered.add(rec)
|
||||
rep = _OutputReport(project)
|
||||
rep.facts["기록"] = len(records)
|
||||
rep.facts["원장이 덮은 기록"] = len(covered)
|
||||
rep.facts["원장 없는 기록"] = len(records) - len(covered)
|
||||
for rec in sorted(records - covered):
|
||||
rep.warn("이 기록을 만든 런 원장이 없다", rec)
|
||||
reports.append(rep)
|
||||
return reports
|
||||
|
||||
|
||||
def main() -> int:
|
||||
parser = argparse.ArgumentParser(description="Verify the Tech Log documentation pipeline workspace.")
|
||||
parser.add_argument("shared_root", nargs="?", type=Path,
|
||||
@@ -373,6 +449,7 @@ def main() -> int:
|
||||
layouts = [] if args.skip_projects else verify_layouts(args.shared_root)
|
||||
runs = [] if args.skip_projects else verify_runs(args.shared_root)
|
||||
outputs = [] if args.skip_projects else verify_outputs(args.shared_root)
|
||||
coverage = [] if args.skip_projects else verify_run_coverage(args.shared_root)
|
||||
project_errors = (sum(r.error_count for r in reports)
|
||||
+ sum(r.error_count for r in layouts)
|
||||
+ sum(r.error_count for r in runs)
|
||||
@@ -400,10 +477,18 @@ def main() -> int:
|
||||
|
||||
if runs:
|
||||
run_errors = sum(r.error_count for r in runs)
|
||||
# 대조를 못 한 영수증(그 뒤에 스킬이 고쳐졌다 · git 을 못 봤다)은 error 도 아니고
|
||||
# 「봤고 괜찮다」도 아니다. 따로 센다 — 0 으로 뭉개면 초록으로 보인다.
|
||||
# 「누가 돌렸는지 모르는 단계」도 같은 자리인데 고치는 방법이 달라 칸을 나눈다 —
|
||||
# 스킬을 열었다는 증거가 없는 것과, 증거는 있는데 연 사람이 안 적힌 것은 다른 일이다
|
||||
unverified = sum(int(r.facts.get("대조 못 한 영수증") or 0) for r in runs)
|
||||
unattributed = sum(int(r.facts.get("누가 돌렸는지 모르는 단계") or 0) for r in runs)
|
||||
print()
|
||||
print(f"PIPELINE RUNS: {'FAIL' if run_errors else 'PASS'}"
|
||||
f" — 런 {len(runs)} · error {run_errors} ·"
|
||||
f" warn {sum(r.warn_count for r in runs)}")
|
||||
f" warn {sum(r.warn_count for r in runs)}"
|
||||
f" · 대조 못 한 영수증 {unverified}"
|
||||
f" · 누가 돌렸는지 모르는 단계 {unattributed}")
|
||||
for report in runs:
|
||||
verifier_render(report, args.samples)
|
||||
|
||||
@@ -425,6 +510,16 @@ def main() -> int:
|
||||
for report in outputs:
|
||||
verifier_render(report, args.samples)
|
||||
|
||||
if coverage:
|
||||
total = sum(int(r.facts.get("기록") or 0) for r in coverage)
|
||||
cov = sum(int(r.facts.get("원장이 덮은 기록") or 0) for r in coverage)
|
||||
print()
|
||||
# error 를 내지 않는다. 덮이지 않은 것은 결함이 아니라 **모르는 것**이다
|
||||
print(f"RUN COVERAGE: 기록 {total} · 원장이 덮은 기록 {cov}"
|
||||
f" · 원장 없는 기록 {total - cov}")
|
||||
for report in coverage:
|
||||
verifier_render(report, args.samples)
|
||||
|
||||
return 1 if errors or project_errors else 0
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user