Development Preview — Coming Soon!

Overview

Getting Started

Projects

Usage
Introduction
Principles
Guidelines
  • Accessibility
    • Accessibility from day one
  • Code Quality
    • Bulk operation verification
    • Linting from day one
    • Scope discipline
    • Small, atomic commits
  • Concurrency
    • Immutability
    • No blocking the main thread
  • Database Design
    • SQLite best practices
  • Feature Management
    • A/B testing
    • Debug mode
    • Feature flags
  • Internationalization
    • Localizability
    • RTL layout support
  • Language
    • Csharp
      • Dependency Injection
      • Naming
      • Nullable Reference Types
    • Kotlin
      • Font Scaling
    • Python
      • Dashboard service is display-only
      • Database
      • Deterministic IDs
      • File paths
      • No external dependencies in core libraries
      • Shell scripts
      • Type hints
      • Use roadmap_lib
      • Web services
      • YAML frontmatter
    • Swift
      • Dynamic Type
      • Use AppKit and UIKit, not SwiftUI
  • Logging
    • Analytics
    • Instrumented logging
  • Networking
    • API Design
    • Caching
    • Error Responses
    • Offline and Connectivity
    • Pagination
    • Rate Limiting
    • Real-Time Communication
    • References
    • Retry and Resilience
    • Timeouts
  • Platform
    • Background tasks
    • Deep linking
    • Handoff and continuity
    • Notifications
    • Scriptable and automatable
    • Search integration
    • Share and inter-app data flow
    • Widgets and glanceable surfaces
    • Windows
      • Architecture
      • Design-Time Data
      • Fluent Design
      • High DPI / Display Scaling
      • MSIX Packaging
      • Theming
  • Security
    • Authentication
    • Authorization
    • Content Security Policy
    • CORS
    • Dependency Security
    • Input Validation
    • Privacy and security by default
    • References
    • Secure Storage
    • Security Headers Checklist
    • Sensitive Data
    • Token Handling
    • Transport Security
  • Skills And Agents
    • Agent Lint Checklist
    • Agent Structure Reference
    • Authoring Skills and Rules
    • Performance: Speed and Token Efficiency
    • Rule Lint Checklist
    • Rule Structure Reference
    • Skill Lint Checklist
    • Skill Structure Reference
  • Testing
    • Comprehensive unit testing
    • Flaky Test Prevention
    • Mutation Testing
    • Post-generation verification
    • Properties of Good Tests
    • Property-Based Testing
    • References
    • Security Testing
    • Test Data
    • Test Doubles
    • Test Pyramid
    • The Testing Workflow
    • Unit Test Patterns
  • Ui
    • Always show progress
    • Animation & Motion
    • Color
    • Data Display
    • Feedback Patterns
    • Form Design
    • Iconography
    • Layout
    • Platform Design Languages
    • Previews
    • Spacing
    • State Design
    • Touch & Click Targets
    • Typography
    • Visual Hierarchy
Ingredients
Recipes
Workflows
Compliance
Reference
Appendix

Networking

10 documents

API Design

Use REST with consistent conventions. Follow the platform API guidelines (Microsoft, Google,

Caching

Use HTTP caching headers. The server controls cache policy; the client honors it.

typescriptweb

Error Responses

Use [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457) format with

Offline and Connectivity

For apps that must work offline, design for local-first with background sync.

web

Pagination

Prefer **cursor pagination** for most APIs — stable under concurrent mutations, consistent

Rate Limiting

Respect server rate limits. Handle 429 responses gracefully.

Real-Time Communication

Choose the simplest technique that meets your needs.

web

References

1. [Microsoft REST API Guidelines](https://github.com/microsoft/api-guidelines)

Retry and Resilience

Not every failure is permanent. Retry transient failures with exponential backoff and jitter.

typescriptweb

Timeouts

Always set both connection and read timeouts. Never use infinite timeouts.

📖The Agentic Developer Cookbook🪪The Agentic Persona Registry🪣My Agentic Storage🧰Agentic Persona Toolkit🛠️Agentic Developer Team👤User Data Store🎭Learn True Facts