By indenscale
Progressive formalization system that bridges unstructured Markdown documentation and strict data schemas.
npx claudepluginhub joshuarweaver/cascade-content-creation-misc-1 --plugin indenscale-typedownSafely introduce external Git repositories as reference materials. Responsible for managing the `_reference` directory, ensuring external code is read-only and does not pollute the project's version control.
'Task as Code' management expert. Responsible for maintaining task files in the todos/ directory, ensuring continuous task IDs, clear statuses, and adherence to specifications.
Expert guidance on writing correct Typedown code, focusing on syntax, best practices, and common pitfalls.
Progressive Formalization for Markdown
🚀 Install VS Code Extension · Documentation · Issues
English | 简体中文
Typedown adds a semantic layer to Markdown, transforming it from loose text into a validated knowledge base.
💡 Typedown files (
.td) are designed to be experienced in an IDE. Install the VS Code Extension to get real-time validation, intelligent navigation, and semantic highlighting.
Markdown is the universal standard for technical documentation. But as your repository grows from 10 to 10,000 files, it becomes a "write-only" graveyard:
| Problem | Description | Typedown Solution |
|---|---|---|
| Schema Errors | Inconsistent data: Status: Active vs status: active, missing required fields | Model - Define structure with Pydantic, validate at compile time |
| Broken References | Links break after moving files: [[./old-path]] points nowhere | Reference - Content-addressed links that auto-track entity changes |
| Constraint Violations | Rules are broken: admins without MFA, inventory over limit | Spec - Executable business rules for complex constraints |
Define data structures using Pydantic:
```model:User
class User(BaseModel):
name: str
role: Literal["admin", "member"]
mfa_enabled: bool = False
```
Instantiate data with strict YAML:
```entity User: user-alice-v1
name: "Alice"
role: "admin"
mfa_enabled: true
```
Link entities with [[...]] syntax:
This task is assigned to [[user-alice-v1]].
Supports ID references ([[entity-id]]) and content hash ([[sha256:...]]).
Three layers of validation:
# 1. Field-level - @field_validator
class User(BaseModel):
@field_validator('email')
def check_email(cls, v):
assert '@' in v, "Invalid email"
return v
# 2. Model-level - @model_validator
class Order(BaseModel):
@model_validator(mode='after')
def check_dates(self):
assert self.end > self.start, "End must be after start"
return self
# 3. Global-level - spec
```spec:check_admin_mfa
@target(type="User", scope="local")
def check_admin_mfa(user: User):
if user.role == "admin":
assert user.mfa_enabled, f"Admin {user.name} must enable MFA"
```
The best way to experience Typedown is through the IDE extension, which provides real-time validation, go-to-definition, and semantic highlighting.
cookbook/01_getting_started/ folder in VS Code.td file to see Typedown in action⚠️ Note: Typedown files (
.td) appear as plain Markdown on GitHub. The full experience requires the VS Code extension.
For validating Typedown files in CI pipelines or automation:
# Using uv (recommended)
uv tool install typedown
# Using pip
pip install typedown
# Validate a project
typedown check .
# Validate the project
typedown check .
# Check with JSON output
typedown check --json
# Run specific validation
typedown check --target User
The cookbook/ directory contains learning resources designed to be used with the VS Code extension:
cookbook/01_getting_started/ - Progressive tutorials (English & 中文)cookbook/02_use_cases/ - Real-world examples (bid evaluation, PMO SaaS, ERP)💡 Tip: Clone the repo and open it in VS Code with the Typedown extension installed for the best learning experience.
MIT © IndenScale
Automates browser interactions for web testing, form filling, screenshots, and data extraction
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Works with Claude Code, Kiro, Clawd CLI, Gemini CLI, Cursor, Continue, Hermes, and 17+ AI coding assistants. Now with Arabic, German, Spanish, and Chinese (Simplified & Traditional) support.
Payload Development plugin - covers collections, fields, hooks, access control, plugins, and database adapters.
20 modular skills for idiomatic Go — each under 225 lines, backed by 48 reference files, 8 automation scripts (all with --json, --limit, --force), and 4 asset templates. Covers error handling, naming, testing, concurrency, interfaces, generics, documentation, logging, performance, and more. Activates automatically with progressive disclosure and conditional cross-references.