tech-toolkit: Instructions file for Claude Code

CLAUDE.md — tech-toolkit · Thiago Maranhão

Language

All content in this repository — documentation, README files, artifact descriptions, and AI-generated output — must be written in English. Code was always in English; now documentation follows the same rule.

Repository context

Public repository by Thiago Maranhão (Software Architecture Manager) with engineering artifacts extracted from real production environments — templates, prompts, and practical examples across AI, distributed systems, and software architecture.

Artifacts are technical references first, content second: each one was validated in a real context before being published. Many are linked to posts on LinkedIn and Medium, but the repository stands on its own as a reference and reuse source.

Open for community use and contribution.

Structure

/
├── README.md                  # Repository and author overview
├── adr/                       # Templates and instructions for Architecture Decision Records
├── prompts/                   # Reusable prompts for AI tools (LLMs, Gems, etc.)
├── claude-code/               # Skills and hooks for Claude Code
├── dotnet/                    # Production .NET/C# code examples
└── distributed-systems/       # Distributed systems patterns and examples

The structure grows as new artifacts are published. Each folder represents a technical domain, not a file type.

Rules for new artifacts

• Each folder groups artifacts by domain/context, not by file type
• Every artifact must be originated or validated in production — no purely theoretical content
• Every folder must have a README.md with:
  • What it is and what it's for
  • Production context where it was used (without exposing sensitive data)
  • How to use it
  • "Origin and references" section with links to posts that originated or mention the artifacts
• Artifacts must be self-contained — someone arriving from a post link should be able to use them without additional context