feat: pivot to best practices collection (v0.2)#49
Merged
robotlearning123 merged 30 commits intomainfrom Mar 1, 2026
Merged
Conversation
…ttributes Add agent guidance files for all major AI coding tools: - CLAUDE.md at repo root (imports AGENTS.md) - .github/copilot-instructions.md for GitHub Copilot - .github/workflows/copilot-setup-steps.yml for Copilot coding agent - .gitattributes for cross-platform line ending normalization - Update AGENTS.md to reflect v0.1.0 and new provider architecture Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace Markdown issue templates with YAML issue forms for structured input. YAML forms are easier for agents to parse and provide dropdowns, required field validation, and better UX. - bug_report.yml: structured fields with OS dropdown, version inputs - feature_request.yml: category dropdown, structured problem/solution - config.yml: disable blank issues, link to discussions - Remove old bug_report.md and feature_request.md Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Design for pivoting agent-ready from repo maturity scanner to repo infrastructure setup tool. 9 modular providers, CLI + Action, autonomous operation with opinionated defaults. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rewrote design doc to reflect knowledge-layer architecture (skill + MCP check tool + CLI). Added 19-task implementation plan across 3 phases: skill content, check tool, cleanup. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace 10-pillar/5-level scoring framework with 9-area best practices workflow. Agent-ready is now a knowledge layer that teaches agents what a well-set-up repo looks like, not a scanner that scores repos. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
How to write AGENTS.md, CLAUDE.md, copilot-instructions, cursor rules. Cross-tool standards and best practices. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
GitHub Actions best practices: ci.yml, claude.yml, copilot-setup-steps.yml. Language-aware workflows with concrete examples. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Git pre-commit (Lefthook/Husky) + Claude Code PostToolUse hooks. Two-layer quality gate best practices. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Biome vs ESLint, Ruff vs black, type checking, .editorconfig. Modern tooling best practices per language. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
GitHub rulesets via API. Essential rules for agent-guided development. Full API payload example. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Container config for reproducible agent environments. Three isolation tiers, concrete config examples. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Issue forms, PR template, CODEOWNERS, CONTRIBUTING, SECURITY. YAML forms over Markdown templates. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Dependabot, push protection, CodeQL, SECURITY.md. Priority order and API enablement commands. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Delete analysis-patterns, levels, pillars, scoring-rubric. Replaced by per-area best practice references. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Version 2.0.0. Best practices collection positioning. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add a `language` field to ScanContext that detects the primary language: - tsconfig.json exists -> 'typescript' - pyproject.toml/setup.py/requirements.txt -> 'python' - package.json (no tsconfig) -> 'javascript' - else -> 'unknown' Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Area-based readiness checker for 9 areas: agent_guidance, code_quality, testing, ci_cd, hooks, branch_rulesets, templates, devcontainer, security. Returns structured present/missing per area with status computation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Register `agent-ready check [path]` command with --json and --strict options. Human-readable output shows area status icons and missing items. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace get_analysis_framework and get_baseline_scan with a single check_repo_readiness tool. Keep get_repo_context and init_files. Bump MCP server version to 2.0.0. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Delete old scanner pipeline (scanner.ts, scan command, level-gate, profiles, markdown/json output). Simplify types to string-based pillar/level fields. Update init command, MCP tools, and tests. 102 tests pass. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace scan-based action with check-based approach. Remove fail-below-level and profile inputs. Add fail-on-missing input (boolean). Use `agent-ready check --json` with optional --strict. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
New positioning as knowledge layer for AI agents. Three deliverables: Skill, CLI, MCP Server. 9 areas of readiness checking. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Typecheck passes. 102 tests pass, 0 failures. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Project is still early stage. Going from 0.1.0 to 0.2.0 is appropriate. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…CLAUDE.md - --strict now works with --json mode in check command - action.yml uses set +e/set -e instead of || true for proper exit codes - agent-ready.yml rewritten for v2 (removed deleted scan/profile/level refs) - pr-check.yml updated to use check command - CLAUDE.md rewritten to match v2 architecture - Added error handling in checkCommand for nonexistent paths Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…types - Area checks run via Promise.all instead of sequentially - Added AreaName union type for type-safe area keys - Removed __nonexistent__ hack in Python linter check - Used ctx.package_json instead of re-reading package.json - Cached pyproject.toml read (was read 3x, now 1x) - Consolidated glob patterns with brace expansion - Cleaned up types.ts: removed 15 dead v1 types - Cleaned up lib.ts: removed dead check/i18n exports - Updated template checkIds from old pillar naming to area-based Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Removed: - src/checks/ (11 files) — old check executors replaced by checker.ts - src/i18n/ (4 files) — locale system no longer used - test/checks.test.ts, test/i18n.test.ts — tests for deleted code - readiness.json — old scan output format - spec/schema/scan-result.schema.json — old result schema Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
All 5 examples updated to use v0.2 action with path/fail-on-missing inputs, replacing deleted v1 inputs (levels, scores, verbose, etc.) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…tting Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Three deliverables rebuilt:
SKILL.md+ 8 reference docs (agent-guidance, code-quality, ci-cd, hooks, branch-rulesets, repo-templates, devcontainer, security)agent-ready check .with--jsonand--strictflagscheck_repo_readinesstool (replacesget_analysis_framework+get_baseline_scan)Key changes:
src/checker.ts— 9-area readiness checker withPromise.allparallelism,AreaNameunion typeTest plan
npm run checkpasses all gatesnpm run dev -- check .produces correct outputnpm run dev -- check . --jsonproduces valid JSONnpm run dev -- check . --json --strictexits 1 when areas missing🤖 Generated with Claude Code