Skip to content

fernandoxavier02/engineering-context

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

engineering-context

Claude Code plugin that generates a mandatory engineering context system for any project — architecture contract, engineering principles, testing strategy, and anti-pattern catalog, all adapted to the project's actual stack.

What it does

Scans your repository, detects the stack, maps the architecture, mines anti-patterns from real code, and writes four always-loaded rules plus vault cards. The resulting rules are compactation-safe (load on every turn) and vault-linked (pull deeper detail on demand).

Slash commands (6)

Command What it does
/engineering-context:setup Full 5-phase pipeline
/engineering-context:detect-stack Auto-detect language / framework / tests
/engineering-context:map-architecture Map layers + dependency rules
/engineering-context:mine-anti-patterns Scan codebase for real anti-patterns
/engineering-context:generate-rules Write .claude/rules/50–53 + vault cards
/engineering-context:validate-context Run validation tests + GO/NO-GO report

Each command invokes the corresponding skill. Skills also activate via natural language (e.g. "set up engineering context", "detect project stack").

Output artifacts

After running setup, the plugin writes:

  • .claude/rules/50-architecture-contract.md — forbidden imports, layer diagram, mandatory flows
  • .claude/rules/51-engineering-principles.md — SOLID / DRY / YAGNI / KISS with real examples from the codebase
  • .claude/rules/52-testing-strategy.md — test type by layer, regression rules
  • .claude/rules/53-anti-patterns.md — catalog of real issues found during scan
  • vault/engineering/ — ADRs, layer contract detail, pattern examples (progressive disclosure)
  • Validation test in the project's native test framework (pytest / jest / go test)

Install

Via marketplace (recommended)

/plugin marketplace add fernandoxavier02/Pipeline-Orchestrator
/plugin install engineering-context@FX-Studio-AI

Direct from this repo

/plugin marketplace add fernandoxavier02/engineering-context
/plugin install engineering-context

Requirements

  • Claude Code CLI with plugin support
  • Project with detectable stack (Python, TypeScript, Go, Rust, Java, or Ruby)
  • Write access to .claude/rules/ in the target project

Language support

Auto-adapts examples to: Python (pytest, pydantic, structlog), TypeScript (jest/vitest, zod), Go (go test, fmt.Errorf), Ruby (rspec, rubocop), Rust, Java.

License

MIT — see LICENSE.

About

Claude Code plugin generating engineering rules, architecture contracts, anti-pattern catalogs, and validation tests adapted to any project stack. Part of the FX Studio AI cross-platform suite.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages