Skip to content

Conversation

@tkhongsap
Copy link

Refactored ai-dev-tasks to support multiple programming languages through modular architecture, addressing GitHub issue #57.

Changes

Core Architecture

  • Refactored generate-tasks.md as universal workflow with smart router
  • AI auto-detects programming language from user context
  • Modular lang/ directory for language-specific configurations
  • Zero duplication of core workflow logic (DRY principle maintained)

Language Support

  • Created lang/typescript.md: TypeScript/JavaScript with Jest
  • Created lang/python.md: Python with pytest
  • Created lang/go.md: Go with built-in testing package
  • Created lang/README.md: Language index and contribution guide

Each language config includes:

  • File extensions and naming conventions
  • Testing frameworks and commands
  • Directory structure patterns
  • Language-specific best practices
  • Example task list entries

Front Matter Support

  • Created docs/front-matter-schema.md: Complete YAML metadata specification
  • Added front matter generation to generate-tasks.md
  • Added front matter generation to create-prd.md
  • Includes required fields: doc_type, id, slug, version, author, ai_model
  • Optional fields: title, description, language, tags, changelog, etc.

Documentation

  • Updated README.md with multi-language support section
  • Added repository structure diagram
  • Updated benefits and usage instructions
  • Added language contribution guidelines

Benefits

  • Single file reference for users (AI auto-detects language)
  • Easy to add new languages (create one small config file)
  • Clean git history (language changes isolated)
  • Sustainable maintenance (core workflow in one place)
  • Professional metadata tracking and versioning

Usage

Simple (AI auto-detects):
@generate-tasks.md create tasks for my Python project from @prd-auth.md

Explicit (guaranteed):
@generate-tasks.md @lang/python.md create tasks from @prd-auth.md

Closes #57

🤖 Generated with Claude Code

)

Refactored ai-dev-tasks to support multiple programming languages
through modular architecture, addressing GitHub issue snarktank#57.

## Changes

### Core Architecture
- Refactored generate-tasks.md as universal workflow with smart router
- AI auto-detects programming language from user context
- Modular lang/ directory for language-specific configurations
- Zero duplication of core workflow logic (DRY principle maintained)

### Language Support
- Created lang/typescript.md: TypeScript/JavaScript with Jest
- Created lang/python.md: Python with pytest
- Created lang/go.md: Go with built-in testing package
- Created lang/README.md: Language index and contribution guide

Each language config includes:
- File extensions and naming conventions
- Testing frameworks and commands
- Directory structure patterns
- Language-specific best practices
- Example task list entries

### Front Matter Support
- Created docs/front-matter-schema.md: Complete YAML metadata specification
- Added front matter generation to generate-tasks.md
- Added front matter generation to create-prd.md
- Includes required fields: doc_type, id, slug, version, author, ai_model
- Optional fields: title, description, language, tags, changelog, etc.

### Documentation
- Updated README.md with multi-language support section
- Added repository structure diagram
- Updated benefits and usage instructions
- Added language contribution guidelines

## Benefits

- Single file reference for users (AI auto-detects language)
- Easy to add new languages (create one small config file)
- Clean git history (language changes isolated)
- Sustainable maintenance (core workflow in one place)
- Professional metadata tracking and versioning

## Usage

Simple (AI auto-detects):
@generate-tasks.md create tasks for my Python project from @prd-auth.md

Explicit (guaranteed):
@generate-tasks.md @lang/python.md create tasks from @prd-auth.md

Closes snarktank#57

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make generate-tasks.md language agnostic for more general use (& front matter)

1 participant