Skip to content

JohnCari/NatLangDev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NatLangDev

Coding in "Natural Language" — Prevent vibe coding with structured AI prompts

What is NatLangDev?

NatLangDev (Natural Language Developer Guide) is a collection of curated guidelines that help developers communicate effectively with AI coding assistants like Claude Code.

The Problem: Vibe Coding

"Vibe coding" happens when developers prompt AI assistants without clear constraints or standards, resulting in:

  • Inconsistent code quality
  • Security vulnerabilities
  • Poor architectural decisions
  • Code that "works" but violates best practices

The Solution: Structured Guidelines

Instead of vague prompts like "write me a web server", NatLangDev provides explicit rules that AI assistants follow. By adding these guidelines to your AI's context, you get code that adheres to proven standards — whether that's NASA's safety-critical rules, idiomatic language patterns, or framework-specific conventions.

Structure

natlangdev/
├── languages/
│   ├── rust/       # Rust guidelines
│   ├── python/     # Python guidelines
│   └── typescript/ # TypeScript guidelines
├── frameworks/
│   ├── nextjs/     # NextJS (TSX) guidelines
│   ├── axum/       # Rust Axum guidelines
│   ├── fastapi/    # FastAPI (Python) guidelines
│   └── pytorch/    # PyTorch (Python) guidelines
├── patterns/       # Cross-language design patterns
├── workflows/      # Development workflows
├── stacks/         # Recommended tech stacks
└── vscode/         # VS Code configurations

Languages

Rust

Python

TypeScript

Frameworks

NextJS (TSX)

Axum (Rust)

FastAPI (Python)

PyTorch (Python)

Patterns

Workflows

  • Lisa Flow — Structured AI development with automatic TDD and self-healing tests

Stacks

  • FastMVP — Vercel + NextJS + Convex/Supabase + Clerk + Stripe for rapid MVP development

VS Code

  • Review & Orchestration Mode — VS Code settings optimized for reviewing AI-generated code (disables autocomplete, strips UI bloat, enhances diff view)

Recommended Extensions

  • Claude Code — Run Claude Code directly in VS Code
  • Error Lens — Inline error/warning highlighting for quick review

Other extensions vary by project — ask Claude Code for recommendations based on your stack.

Contributing

Contributions welcome! Feel free to submit guidelines for additional languages or improvements to existing ones.

License

CC0 1.0 Universal — Public Domain

About

The Natural Language Developer Guide

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published