feat: Add AI Context Convention Linters module

Author: killerapp

linters/.context.md

@@ -1,9 +1,52 @@
 ---
-directoryName: linters
+module-name: AI Context Convention Linters
+related-modules:
+  - ../examples
+version: 1.0.0
 description: Contains linting tools for validating AI Context Convention files
-languages:
+diagrams: []
+technologies:
   - Python
   - TypeScript
+conventions:
+  - Follow language-specific best practices
+  - Adhere to AI Context Convention Specification
+directives:
+  - Ensure consistency between different language implementations
+  - Write clear, well-documented code
+architecture:
+  style: Multi-language
+  components:
+    - Python linter
+    - TypeScript linter
+  data-flow:
+    - Input files -> Language-specific linter -> Validation results
+development:
+  setup-steps:
+    - Clone the repository
+    - Follow language-specific setup instructions in each subdirectory
+  build-command: See individual linter directories
+  test-command: See individual linter directories
+business-requirements:
+  key-features:
+    - Validate structure of context files
+    - Ensure required fields are present
+    - Check for proper YAML frontmatter in Markdown files
+  target-audience: Developers using the AI Context Convention
+  success-metrics:
+    - Consistency of linting results across languages
+    - Adoption rate among project contributors
+quality-assurance:
+  testing-frameworks:
+    - Language-specific testing frameworks (see subdirectories)
+  coverage-threshold: 90%
+  performance-benchmarks:
+    - Linting speed for various file sizes and complexities
+deployment:
+  platform: GitHub
+  cicd-pipeline: GitHub Actions
+  staging-environment: N/A
+  production-environment: GitHub Releases
 ---
 
 # Linters Directory

linters/python/.context.md

@@ -4,6 +4,8 @@ related-modules:
   - ../typescript
 version: 0.0.1
 description: Python implementation of the AI Context Convention linter (placeholder)
+project-type: Linter
+diagrams: []
 technologies:
   - Python
 conventions:

linters/typescript/.context.md

@@ -1,11 +1,59 @@
 ---
-directoryName: typescript
+module-name: TypeScript Linter for AI Context Convention
+related-modules:
+  - ../python
+version: 1.0.0
 description: TypeScript implementation of the AI Context Convention linter
-mainFile: typescript_linter.ts
-language: TypeScript
-dependencies:
+project-type: Linter
+diagrams: []
+technologies:
+  - TypeScript
+  - Node.js
   - js-yaml
   - markdown-it
+conventions:
+  - Follow TypeScript best practices and coding conventions
+  - Use strict mode and appropriate type annotations
+directives:
+  - Keep the linter consistent with the Python implementation
+  - Write unit tests for all functionality
+architecture:
+  style: Module-based
+  components:
+    - typescript_linter.ts (main linter script)
+    - YAML parser
+    - Markdown parser
+    - JSON parser
+  data-flow:
+    - Input files -> Parser -> Validator -> Output results
+development:
+  setup-steps:
+    - Install Node.js (v14+) and npm
+    - Install required dependencies
+    - Compile TypeScript code
+  build-command: tsc typescript_linter.ts
+  test-command: npm test
+business-requirements:
+  key-features:
+    - Validate structure of context files
+    - Ensure required fields are present
+    - Check for proper YAML frontmatter in Markdown files
+    - Verify content adheres to AI Context Convention Specification
+  target-audience: Developers using the AI Context Convention
+  success-metrics:
+    - Accuracy of linting results
+    - Performance on large codebases
+quality-assurance:
+  testing-frameworks:
+    - Jest
+  coverage-threshold: 90%
+  performance-benchmarks:
+    - Linting speed for various file sizes and complexities
+deployment:
+  platform: npm
+  cicd-pipeline: GitHub Actions
+  staging-environment: npm staging registry
+  production-environment: npm public registry
 ---
 
 # TypeScript Linter for AI Context Convention