skills.rest
cajias
cajiasCOMMUNITY
Explore all skills by this author →
GitHub

design-phase-artifacts

Generate a C4 overview and five design artifacts for Notion publishing.

Updated Nov 18, 2025
Search Tags:#design#planning#architecture#verification#notion#sdlc
One-click install
npx skills add https://github.com/cajias/claude-skills --skill design-phase-artifacts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-phase-artifacts
Source: https://github.com/cajias/claude-skills/tree/main/plugins/dev-process/skills/design-phase-artifacts
Command: npx skills add https://github.com/cajias/claude-skills --skill design-phase-artifacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps when you need to design a non-trivial change before implementation and want a complete, publication-ready package instead of a loose brainstorm. It turns an idea into structured design artifacts that stay grounded in the real codebase and are ready to share in Notion.

Core Features & Use Cases

  • C4-led design framing: Produces an architecture overview that becomes the source of truth for the change.
  • Five coordinated design artifacts: Creates Logical Design, Structural Design, Implementation Plan, Test & Verification Plan, and Evaluation Plan as separate deliverables.
  • Code-grounded planning: Requires reading the actual repository structure and code before drafting so the design reflects what exists.
  • Notion publishing workflow: Includes guidance for creating, updating, and verifying design pages in Notion with the right orchestration flow.
  • Use case: A team asks for “the design” of a feature change, and this Skill generates the full design phase package needed before implementation starts.

Quick Start

Ask the AI to produce the full design-phase package for your change, grounded in the repository and formatted for publication in Notion.

Frequently Asked Questions about design-phase-artifacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a feature idea into a complete design plan for a non-trivial software change?▼

To turn a feature idea into a design plan, this Skill produces a complete design-phase package with a C4 architecture overview and five coordinated artifacts. It grounds the design in your actual repository before any implementation begins.

What design artifacts do I need for an AI-native SDLC workflow before starting implementation?▼

For an AI-native SDLC workflow, you need Logical Design, Structural Design, Implementation Plan, Test & Verification Plan, and Evaluation Plan. This Skill generates these five publication-ready artifacts aligned to implementation and testing.

How do I generate architecture documentation grounded in my existing repository structure?▼

To generate architecture documentation grounded in your repository, this Skill reads your actual code structure before drafting. It produces a C4-led architecture overview that serves as the source of truth for the planned change.

Can I format software design plans directly for publishing to Notion?▼

Yes, you can format design plans for Notion. This Skill includes guidance for creating, updating, and verifying design pages in Notion, ensuring the generated artifacts are structured and ready for team publication.

Does this design planning approach work for non-trivial software changes only?▼

Yes, this design planning approach targets non-trivial software changes. It requires structured analysis of code, architecture, verification, and operational readiness, making it suitable for complex features rather than simple tweaks.

Related Skills

Explore More Software Engineering Skills→
understudylabsunderstudylabs
10

capture-evidence

Generate harness, metric, splits, and baseline artifacts from workloads.

Official
Advanced
jonathanmalkinjonathanmalkin
61

scope

Scope software implementation work by clarifying requirements, identifying risks, and producing a validated design.

Community
Advanced
eliottbusinesseliottbusiness

notion

Automate Notion API operations for pages, databases, and blocks via curl.

Community
Intermediate
dinoudondinoudon

architecture-blueprint

Create architecture blueprints with C4 diagrams and ADRs using Mermaid and Markdown.

Community
Advanced