10x-stack-assess

Evaluates an existing project's stack against four agent-friendliness quality gates and writes a structured assessment.

Updated May 24, 2026
One-click install
npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-stack-assess-devmachaj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-stack-assess
Source: https://github.com/DevMachaj/Projekt-certyfikacyjny/tree/main/.claude/skills/10x-stack-assess
Command: npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-stack-assess-devmachaj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams adopting AI coding agents on existing (brownfield) projects often don't know whether their current stack helps or hinders agent workflows. This Skill inspects the codebase, scores each stack component against four quality gates (typed, convention-based, popular in training data, well-documented), and produces concrete compensation strategies instead of recommending a rewrite. ## Core Features & Use Cases - Automatic stack detection: Reads project markers (package.json, Cargo.toml, pyproject.toml, go.mod, Gemfile, composer.json, *.csproj, pubspec.yaml) to identify language, framework, build tool, test runner, package manager, CI/CD, and deployment target. - Quality gate scoring with evidence: Scores each component against the four gates, citing the specific file or config that justifies every pass or fail, and assesses training-data popularity within the language family rather than globally. - Compensation strategies: For every failed gate, generates ready-to-paste CLAUDE.md/AGENTS.md rule entries so agents can work effectively despite the gap, then writes the full report to context/foundation/stack-assessment.md. - Use Case: A developer with an existing Express + JavaScript project asks whether their stack is agent-friendly. The Skill detects the stack, flags the untyped and non-convention-based gaps, and outputs concrete instruction-file rules (type annotations at boundaries, documented routing conventions) plus an overall readiness verdict. ## Quick Start Ask the agent to assess your stack by running /10x-stack-assess in your project directory, optionally passing a path to your brownfield PRD for extra context.

Frequently Asked Questions about 10x-stack-assess

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate if my existing project stack is agent-friendly?

Run the stack assessment in your project root. It detects your language, framework, build tool, and test runner from project marker files, scores each against four quality gates (typed, convention-based, training-data popularity, documentation), and writes a report to context/foundation/stack-assessment.md.

What are the four agent-friendly stack quality gates?

The gates are: typed (explicit types or configured type checking), convention-based (framework-enforced structure), popular in training data (mainstream within its language family), and well-documented (current, versioned official docs). Each component is scored with evidence from your project files.

Does the stack assessment recommend switching frameworks?

No. The assessment never recommends replacing your stack. When a gate fails, it produces compensation strategies: concrete, ready-to-paste rules for CLAUDE.md or AGENTS.md so agents can work effectively despite the gap.

Which project types and languages does stack detection support?

Detection covers JavaScript/TypeScript, Python, Rust, Go, Ruby, PHP, .NET, and Dart via marker files like package.json, pyproject.toml, Cargo.toml, go.mod, Gemfile, composer.json, csproj, and pubspec.yaml. It also detects CI/CD, deployment targets, and existing instruction files.

When should I not run a brownfield stack assessment?

Skip it when starting a new project from scratch; use a greenfield tech stack selector instead. Also skip it if you only want a dependency audit or security scan without the quality-gate framing, which is health-check territory.

What happens if stack-assessment.md already exists?

The Skill asks how to proceed before writing: overwrite the existing assessment, save a versioned copy such as stack-assessment-v2.md to preserve history, or abort and keep the assessment in the conversation only.