agentleFS
deokjinlogdeokjinlog/intent-locked-workflow/skills/auto-tech-design/SKILL.md

auto-tech-design

Skill0 starsChanged 4 months agoMITView on GitHub

auto-flow 2단계 — requirements.md 읽기 + adaptive 7-topic 자동 판정 + design decision 자동 alternatives 비교 → recommendation 자동 선택 + verifying-spec 4축 보고서 transition 직전 노출 + auto-writing-plans 자동 invoke. AskUserQuestion 호출 X — clarifying Q 는 prose 질의다 (본문 Anti-Patterns 와 CLAUDE.md 정본). generating-html 은 Step 4.5 fire-and-forget dispatch (v2.3.2+ — v1.1.17 '호출 부재' 룰이 반전됨).

The file

Files
SKILL.md

Auto Designing Direction → <slug>-tech-design.md (auto)

Checklist

  • Step 1 — 입력 확인 + slug 추론
  • Step 2 — adaptive 7-topic 자동 판정
  • Step 3 — AI 자동 design decision (각 활성 토픽)
  • Step 4 — 산출물 자동 작성 (<slug>-tech-design.md)
  • Step 4.5 — generating-html fire-and-forget dispatch + 5초 race delay
  • Step 5 — verifying-spec 자동 실행 (4축 보고서)
  • Step 6 — change-history 자동 ([개발방향-수정] entry)
  • Step 7 — Transition notice + auto-writing-plans invoke

Process

Step 1 — 입력 확인 + slug 추론

<slug>-requirements.md 존재 확인. 인자 누락 시 scripts/auto_flow.find_latest_slug(Path("docs/features")) 호출.

Step 2 — adaptive 7-topic 자동 판정

<slug>-requirements.md 본문 분석. 항상 활성 4 (1,2,5,6) + 조건부 3 (3,4,7). 메인이 본문 컨텍스트로 판단 + 한 줄 announce:

ℹ️ 활성 토픽은 ... 이고, 비활성 토픽은 ... 입니다 (이유: ...). 자동 흐름이라 사용자 응답 없이 다음 단계로 넘어갑니다.

→ 사용자 catch 가능 위치이지만 응답 wait X.

Step 3 — AI 자동 design decision

각 활성 토픽에 대해 메인이 2-3 alternatives + recommendation 1개 자동 선택 (D-T3). reasoning 은 §5 결정+대안 비교 에 logged. 비활성 토픽은 N/A 한 줄.

Step 4 — 산출물 자동 작성

<slug>-tech-design.md 7-section schema 따라 작성. RAW .md 본문.

Step 4.5 — generating-html fire-and-forget dispatch (v2.3.2+)

<slug>-tech-design.md 작성 직후, change-history entry 박히기 전 (footer 비어있음) 에 generating-html skill fire-and-forget dispatch (run_in_background: true). 메인 latency 거의 0. transition notice 시점에 사용자가 .html 검토 가능 (Type "stop" abort). v1.1.17 PRD D9 amend 반전 (v2.3.2+).

v2.4+ race delay: dispatch 후 5초 delay 후에 Step 5 (verifying-spec) 진행. background subagent 가 .md 의 footer 0건 시점에 읽도록 보장 (race condition 해결).

Step 5 — verifying-spec 자동 실행

verifying-spec skill invoke (메인 자체 수행 또는 skill 호출). 4축 보고서 생성. 결과는 다음 단계 transition notice 직전 노출.

Step 6 — change-history 자동

change-history skill invoke → 첫 [개발방향-수정] entry. CH-id 자동.

Step 7 — Transition notice + auto-writing-plans invoke

🔍 verifying-spec 결과:
   - A1 consistency: ✅
   - A2 ...
   - C1 impact: ⚠️ 영향 N 컴포넌트
   - C2 ...

ℹ️ /writing-plans 단계로 자동 넘어갑니다. 멈추려면 "stop" 입력해주세요.

parse_interrupt 매치 시 exit + ℹ️ 알겠습니다. /writing-plans 은 나중에 직접 실행해주세요. 안내. 매치 X → intent-locked-workflow:auto-writing-plans invoke.

--no-ask 플래그 (v2.5+) — 짧은 reference

본 skill 흐름은 AskUserQuestion 호출이 본문에 명시 X (clarifying Q 자체가 prose default). --no-ask 플래그 진입 시 추가 분기 없음 — 본문 그대로 도구 호출 0 보장.

단 내부 escalation (BLOCKED 자가복구 실패 / critical 7 재질문 / Other 모호 응답) 에서도 도구 호출 0 보장. 자세한 룰은 skills/brainstorming/SKILL.md 의 ### 예외 — \--no-ask` 플래그 (v2.5+)` 답습.

Anti-Patterns

WrongRight
AskUserQuestion 호출NEVER.
generating-html 동기 호출 (sync wait)NEVER. v2.3.2+ — Step 4.5 fire-and-forget 만. (v1.1.17 "호출 부재" 룰 v2.3.2 반전.)
일반 tech-design skill body 호출NEVER. self-contained mirror (D-T1).
transition notice 후 wait sleepNEVER.

Related Skills

  • auto-writing-plans — 다음 단계
  • verifying-spec — 4축 보고서 생성
  • change-history — 첫 entry append
  • scripts/auto_flow.parse_interrupt, find_latest_slug

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.