https://github.com/fernandoxavier02/engineering-context
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.
https://github.com/fernandoxavier02/engineering-context
claude-code context-engineering developer-tools engineering-rules fx-studio-ai
Last synced: 10 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/fernandoxavier02/engineering-context
- Owner: fernandoxavier02
- License: mit
- Created: 2026-04-23T23:14:10.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-04T19:53:58.000Z (20 days ago)
- Last Synced: 2026-06-14T23:34:20.684Z (10 days ago)
- Topics: claude-code, context-engineering, developer-tools, engineering-rules, fx-studio-ai
- Language: Python
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](LICENSE).