agentleFS
HarryJhinHarryJhin/groundwork/skills/design-review/SKILL.md

design-review

Skill0 starsChanged 3 months agoMITView on GitHub

Use when a design proposal is ready for review or an existing design changed.

155 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use project-stage-detect, team-audio and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • CoralGameSkill

    project-stage-detect

    Automatically analyze project state, detect stage, identify gaps, and recommend next steps based on existing artifacts.

    Also in 16 projects that use this

  • CoralGameSkill

    team-audio

    Orchestrate audio team: audio-director + sound-designer + technical-artist + gameplay-programmer for full audio pipeline from direction to implementation.

    Also in 13 projects that use this

  • julianoczkowskiSkill

    brief-to-tasks

    Break a design brief into an ordered checklist of independently buildable tasks using vertical slices. Saves as a markdown checklist. Use when user wants to break down work, create tasks from a brief, plan implementation order, or mentions "tasks" or "breakdown".

    Also in 7 projects that use this

  • lilangMaxSkill

    asset-spec

    Generate per-asset visual specifications and AI generation prompts from GDDs, level docs, or character profiles. Produces structured spec files and updates the master asset manifest. Run after art bible and GDD/level design are approved, before production begins.

    Also in 10 projects that use this

  • lilangMaxSkill

    create-control-manifest

    After architecture is complete, produces a flat actionable rules sheet for programmers — what you must do, what you must never do, per system and per layer. Extracted from all Accepted ADRs, technical preferences, and engine reference docs. More immediately actionable than ADRs (which explain why).

    Also in 10 projects that use this

  • +4 more from CoralGame
  • +3 more from lilangMax

The file

Files
SKILL.md

design-review

Execution contract

입력은 설계 문서 경로 또는 대화의 설계안이다. 메인 저자가 요청·대화의 합의와 필요한 리포 사실을 대조해 한 번 점검한다. 문서 경로는 작업 리포 루트 기준이다. 대상이 하나로 식별되지 않으면 어떤 설계를 점검할지 확인한다. 출력은 통과 또는 조건부 통과와 잔여 문제다. 별도 리뷰어·반복 라운드·리뷰 기록 파일을 만들지 않는다.

Check the contract

  • 요청의 목표와 범위가 맞고, 요청하지 않은 기능이 들어오지 않았는가.
  • 적용되는 서비스 흐름에서 사용자 결과가 명확한가. 기존 구현·참조 정책을 사용자 요청 없이 새 목표로 가져오지 않았는가.
  • 사용자 결과가 달라지는 미정 사항이나 기존 합의를 재검토할 근거가 남아 있는가.
  • 중요한 사실과 기술 가정에 확인 가능한 근거가 있는가. 변경이 기존 데이터·공개 계약·다른 사용자에게 미치는 영향을 다뤘는가.
  • 완료 기준이 서비스 결과를 덮고 참·거짓과 확인 방법이 갈리는가.

필요한 내용이 있는지 점검하며 고정 절의 존재를 채점하지 않는다. 파일·함수·내부 알고리즘 등 같은 계약을 만족하는 선택이 비어 있는 것은 결함이 아니다.

Resolve and report

이미 확정된 정책과 확인한 사실로 고칠 수 있으면 그 자리에서 고친다. 기술 문제는 저자가 조사하고 결정한다. 남은 도메인 결정과 기존 합의를 바꿀 근거는 groundwork:finding-unknowns의 Explain the decision before asking에 따라 사용자와 검토한다. 확인하지 못한 사실은 가정과 영향을 남긴다. 잔여가 없으면 통과다. 잔여가 있으면 조건부 통과로 위치·영향·필요한 정책 결정이나 사실 확인을 보고한다. 개정 내용을 반영한 최종 상태를 판정하고, 실행 가능한 범위는 요청에 따라 진행한다.

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.