feat: pivot to best practices collection (v0.2)

.gitattributes

@@ -0,0 +1,16 @@
+# Auto detect text files and normalize line endings
+* text=auto
+
+# Source
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.md text eol=lf
+
+# Binary
+*.png binary
+*.jpg binary
+*.gif binary
+*.ico binary

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,67 @@
+name: Bug Report
+description: Report a bug with agent-ready
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+      placeholder: A clear description of the bug
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this?
+      value: |
+        1. Run `agent-ready scan ...`
+        2.
+        3.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should have happened?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What happened instead?
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: agent-ready version
+      placeholder: "0.1.0"
+    validations:
+      required: true
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js version
+      placeholder: "20.10.0"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux
+        - Windows
+    validations:
+      required: true
+  - type: textarea
+    id: output
+    attributes:
+      label: Command Output
+      description: Paste the full command output if relevant
+      render: shell

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discussions
+    url: https://github.com/agent-next/agent-ready/discussions
+    about: Ask questions and share ideas

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,43 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this solve?
+      placeholder: "I'm always frustrated when..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: What should agent-ready do?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any other approaches you've thought about?
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      options:
+        - New provider
+        - Existing provider improvement
+        - CLI UX
+        - GitHub Action
+        - MCP server
+        - Documentation
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Screenshots, mockups, or any other context

.github/copilot-instructions.md

@@ -0,0 +1,11 @@
+TypeScript project using Node 20+ with strict mode enabled.
+
+Commands: `npm test` (152 tests), `npm run check` (typecheck + lint + format), `npm run build` (tsc).
+
+Code style: kebab-case files, PascalCase interfaces, camelCase functions. Interfaces over types. Avoid `any`, use `unknown`. Export types from `src/types.ts`.
+
+Testing: Node built-in test runner via `tsx --test`. Fixtures in `test/fixtures/`. Always run tests after changes and update tests in the same pass as code changes.
+
+Git: Atomic commits with semantic prefixes (feat/fix/docs/chore). Run `npm run check` before committing.
+
+Do not add external API calls — all scanning must remain local. Do not modify `src/types.ts` without updating all consumers.

.github/workflows/agent-ready.yml

@@ -1,47 +1,34 @@
-# Agent Ready - AI Readiness Scanner
-# This workflow runs on PRs and pushes to check repository AI readiness
+# Agent Ready - Repository Readiness Check
+# Runs on PRs and pushes to check repo setup for AI coding agents
 
 name: Agent Ready
 
 on:
   push:
-    branches: [main, master]
+    branches: [main]
   pull_request:
-    branches: [main, master]
+    branches: [main]
 
 permissions:
   contents: read
-  pull-requests: write
 
 jobs:
-  scan:
-    name: Scan Repository
+  check:
+    name: Check Repository
     runs-on: ubuntu-latest
 
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Run Agent Ready Scan
-        id: scan
+      - name: Run Agent Ready Check
+        id: check
         uses: ./
         with:
           path: '.'
-          profile: 'factory_compat'
-          output-format: 'both'
-          fail-below-level: 'none'
-          verbose: 'true'
-          upload-artifact: 'true'
-          comment-on-pr: ${{ github.event_name == 'pull_request' }}
 
       - name: Print Results
         env:
-          LEVEL: ${{ steps.scan.outputs.level }}
-          SCORE: ${{ steps.scan.outputs.score }}
-          PROJECT_TYPE: ${{ steps.scan.outputs.project-type }}
-          PASSED: ${{ steps.scan.outputs.passed }}
+          PASSED: ${{ steps.check.outputs.passed }}
         run: |
-          echo "Level: $LEVEL"
-          echo "Score: ${SCORE}%"
-          echo "Project Type: $PROJECT_TYPE"
           echo "Passed: $PASSED"

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,18 @@
+name: "Copilot Setup Steps"
+
+on:
+  workflow_dispatch:
+
+jobs:
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+      - run: npm ci
+      - run: npm run build

.github/workflows/pr-check.yml

@@ -89,49 +89,18 @@ jobs:
     needs: validate-pr
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
       - name: Setup Node.js
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
+          node-version: '20'
           cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Run agent-ready scan
+      - name: Run agent-ready check
         run: |
           set -eo pipefail
-
-          npm run dev -- scan . --output json
-
-          # Verify the output file was created
-          if [[ ! -f readiness.json ]]; then
-            echo "::error::Scan failed to produce readiness.json output file"
-            exit 1
-          fi
-
-          # Extract values with jq (pre-installed on ubuntu runners)
-          LEVEL=$(jq -r '.level // empty' readiness.json)
-          SCORE=$(jq -r '.overall_score // empty' readiness.json)
-
-          # Validate extracted values
-          if [[ -z "$LEVEL" ]]; then
-            echo "::error::readiness.json missing 'level' field"
-            cat readiness.json
-            exit 1
-          fi
-
-          if [[ -z "$SCORE" ]]; then
-            echo "::error::readiness.json missing 'overall_score' field"
-            cat readiness.json
-            exit 1
-          fi
-
-          echo "## Agent Readiness Report" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
-          echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
-          echo "| Level | **$LEVEL** |" >> $GITHUB_STEP_SUMMARY
-          echo "| Score | $SCORE% |" >> $GITHUB_STEP_SUMMARY
+          npm run dev -- check . --json