skills.rest
leogodin217
leogodin217COMMUNITY
Explore all skills by this author →
GitHub

role-architect

Designs system interfaces and architecture documents with Python function signatures.

60|13|Updated Jan 10, 2026
Search Tags:#design#architecture#python#lsp#contracts#interface
One-click install
npx skills add https://github.com/leogodin217/leos_claude_starter --skill role-architect-leogodin217
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: role-architect
Source: https://github.com/leogodin217/leos_claude_starter/tree/main/.claude/skills/role-architect
Command: npx skills add https://github.com/leogodin217/leos_claude_starter --skill role-architect-leogodin217

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the design of software interfaces, contracts, and architectural decisions, ensuring clarity and adherence to project principles.

Core Features & Use Cases

  • Interface Design: Generates precise Python function signatures for system interfaces.
  • Architecture Documentation: Updates and maintains architecture documents based on design decisions.
  • Sprint Planning: Breaks down implementation phases for upcoming sprints.
  • Use Case: When a new feature requires interaction between two modules, the architect uses this skill to define the exact contract (function signature, parameters, return types, and error conditions) for their communication.

Quick Start

Use the role-architect skill to design the interface contract for a new user authentication module.

Frequently Asked Questions about role-architect

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

FAQPage Schema
How do I design API contracts and interfaces for Python modules?▼

Designing API contracts for Python modules involves generating precise function signatures, defining explicit error handling, and avoiding default parameters. This Skill creates these exact specifications to ensure clear interaction between system components.

What is the best way to document software architecture decisions for a new feature?▼

Documenting software architecture decisions is best handled by updating architecture documents based on design choices. This Skill maintains these records alongside defining the exact module contracts and planning sprint implementations.

How do I plan sprint implementations for software development projects?▼

Planning sprint implementations involves breaking down design phases into actionable tasks. This Skill plans these phases immediately after defining system interfaces and contracts for upcoming features.

Can I use LSP tools for code navigation when defining system architecture?▼

LSP tools can be used for code navigation when defining system architecture. This Skill utilizes LSP capabilities to help design interfaces, update documentation, and adhere to strict contract rules during software development.

Why do Python contracts need explicit error handling and no default parameters?▼

Python contracts need explicit error handling and no default parameters to enforce strict architectural rules and prevent ambiguity. This Skill adheres to these constraints when generating function signatures for system interfaces.

Related Skills

Explore More Software Engineering Skills→
pingmepipingmepi

pm-stage-01-brief

Generate a structured 7-section product brief from a business statement.

Community
Advanced
josemartinrodriguezmortalonijosemartinrodriguezmortaloni

generating-python-code

Generate PEP-compliant Python code with type hints and docstrings.

Community
Intermediate
ramkrish0403ramkrish0403

design-feature

Generate detailed feature specifications from codebase and documentation analysis.

Community
Advanced
matt-fell-aimatt-fell-ai
1

visionary

Converts text-based system descriptions into Mermaid diagram code and architectural sketches.

Community
Intermediate