architecture-format-extended

name	architecture-format-extended
description	Extended architecture templates with full examples. Imports architecture-format-core for base structure.
version	1.1
tier	2
requires	architecture-format-core

Architecture Document Structure (Extended)

[!NOTE] This skill provides FULL templates with detailed examples. It extends architecture-format-core with comprehensive sections 3-10.

When to Load This Skill

Condition	Action
Creating NEW system from scratch	✅ Load this skill
Major refactor (>3 components changed)	✅ Load this skill
Sophisticated requirement / complex task	✅ Load this skill
User explicitly requests full template	✅ Load this skill
Minor architecture update	❌ Use architecture-format-core only

---

3. System Components (Extended Examples)

[!TIP] Example Template: See .agent/skills/architecture-format-extended/examples/component-template.md

Use the detailed component template for defining new services or major components.

---

4. Data Model (Full)

[!TIP] Example Template: See .agent/skills/architecture-format-extended/examples/data-model.md

4.1. Conceptual Data Model

Description of main entities and their relationships at a high level.

4.2. Logical Data Model

Detailed description considering storage technology (Relational vs NoSQL).

4.3. Data Model Diagram

ER-diagram in PlantUML format.

4.4. Migrations and Versioning

Strategy for DB schema changes.

---

5. Interfaces

[!TIP] Example Template: See .agent/skills/architecture-format-extended/examples/api-interface.md

5.1. External APIs

Detailed REST/GraphQL/gRPC definitions including authentication and error handling.

5.2. Internal Interfaces

Interaction between system components (e.g., Message Queues, Events).

5.3. Integrations with External Systems

Third-party service purpose, protocol, and error handling strategies.

---

6. Technology Stack

6.1. Backend

• Programming Language & Framework with justification.

6.2. Frontend

• Framework with justification.

6.3. Database

• Type (SQL/NoSQL) with justification.

6.4. Infrastructure

• Containerization (Docker)
• Orchestration (K8s/Compose)
• Middleware (Redis, RabbitMQ)
• Observability (Prometheus, ELK)

---

7. Security

7.1. Authentication and Authorization

• Auth Mechanism (JWT/OAuth)
• Session Management

7.2. Data Protection

• Encryption (At Rest / In Transit)
• PII handling

7.3. Attack Protection

• OWASP Top 10 (SQLi, XSS, CSRF)
• Rate Limiting

---

8. Scalability and Performance

8.1. Scaling Strategy

• Horizontal vs Vertical scaling plans.

8.2. Caching

• Strategy, specific items, and invalidation rules.

8.3. DB Optimization

• Indexes, Partitioning, Replication.

---

9. Reliability and Fault Tolerance

9.1. Error Handling

• Degredation, Circuit Breakers, Retries.

9.2. Backup

• Strategy, Frequency, Storage.

9.3. Monitoring and Alerting

• Key Metrics (Latency, Errors, Saturation).

---

10. Deployment

10.1. Environments

• Dev, Staging, Prod definitions.

10.2. CI/CD Pipeline

• Build -> Test -> Deploy stages.

10.3. Configuration

• Env vars, Secrets management.

10.4. Deployment Instructions

• Step-by-step guide for deployment and migrations.