{
 "schema": "aiblocks-page/1",
 "id": "system-design-practice-review",
 "type": "skill",
 "name": "System design practice reviewer",
 "summary": "Get a system design review that asks first, then ranks risks and gives a revision checklist. Share your design and see where it may break.",
 "headline": "System design practice reviewer",
 "subhead": "Share your design, expected load and learning goal. It names what works, then asks questions that test your assumptions. You compare options for the biggest risks and get a checklist of the changes you choose to make.",
 "job": {
  "id": "study-and-practice",
  "name": "Study and check your understanding"
 },
 "level": "beginner",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  },
  {
   "type": "codebase",
   "required": false,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  }
 ],
 "outputs": [
  {
   "type": "feedback_notes",
   "required": true,
   "label": "Feedback notes",
   "what": "a person's notes on an output: what to keep, change or drop"
  },
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  }
 ],
 "you_give": [
  "A system design as a diagram, description or code.",
  "Expected load, reliability needs, team limits and learning goal."
 ],
 "you_get": [
  "A question-led review of your design.",
  "Ranked risks and alternatives with tradeoffs.",
  "A revision checklist based on your choices."
 ],
 "use_when": [],
 "skip_when": [
  "You have no design yet: use the Build with me skill to shape one first, then come back for the review.",
  "You do not know a core idea in your design, such as caching or queues: ask your AI to teach that idea first.",
  "Your design is a simple script with no real choices to weigh: a quick read from a teammate is enough."
 ],
 "output_sample": {
  "input": [
   "Your system design as a diagram, a written description or code",
   "Expected load, reliability needs and team limits",
   "Your learning goal (optional)"
  ],
  "output": [
   {
    "name": "Design summary",
    "contains": "A short restatement of your design so you and your AI agree on what is being reviewed."
   },
   {
    "name": "Strengths",
    "contains": "Two or three things your design does well, stated before any criticism."
   },
   {
    "name": "Probe questions",
    "contains": "Two or three questions that test your weakest assumptions, asked before any issues are shown."
   },
   {
    "name": "Issues",
    "contains": "Problems ordered from critical to minor, each with its area and how serious it is."
   },
   {
    "name": "Alternatives",
    "contains": "Two options for each critical or major issue, with the tradeoffs of each."
   },
   {
    "name": "Choice prompt",
    "contains": "A question asking you to pick an option and give your reason."
   },
   {
    "name": "Revision checklist",
    "contains": "Short, concrete next steps based on the changes you chose."
   }
  ]
 },
 "how_to_use": [
  "Open Claude, ChatGPT or Gemini and paste the skill instructions into a new chat.",
  "Paste your design, or describe it. Add your expected load, uptime needs and team limits.",
  "Answer the probe questions in your own words. The AI waits for your reasoning before it lists issues.",
  "Pick an option for each major issue and say why.",
  "Use the final checklist to revise your design yourself. This skill needs no code running, files or paid tools."
 ],
 "checks": [],
 "next": [
  {
   "name": "Study practice progress reviewer",
   "url": "https://useaiblocks.com/skills/study-plan-progress-review-assistant",
   "why": "Study practice progress reviewer"
  }
 ],
 "source": {
  "by": "edu-agent-skills contributors",
  "repo": "yugash007/edu-agent-skills",
  "url": "https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/projects/architecture-review",
  "licence": "MIT",
  "original_name": "architecture-review",
  "commit": "e75f44303570bb2eae37a8f7536c0358be2502ee"
 },
 "credits": [
  {
   "title": "architecture-review skill",
   "by": "edu-agent-skills contributors",
   "url": "https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/projects/architecture-review",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps."
  }
 ],
 "files": [
  "examples.md",
  "LICENSE",
  "README.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/system-design-practice-review",
  "markdown": "https://useaiblocks.com/skills/system-design-practice-review.md",
  "json": "https://useaiblocks.com/skills/system-design-practice-review.json",
  "instructions": "https://useaiblocks.com/skills/system-design-practice-review/SKILL.md",
  "download": "https://useaiblocks.com/skills/system-design-practice-review.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/system-design-practice-review",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/system-design-practice-review",
  "mcp": "https://useaiblocks.com/mcp"
 }
}