Adopter Checklist

Complete this checklist to verify your pair setup is working correctly. This should take less than 30 minutes.

Prerequisites Check

• Node.js 18+ installed: node --version
• pnpm installed: pnpm --version
• Terminal/command line access
• Internet connection (for npm install) or manual download ready

Installation Verification

Step 1: Install pair-cli

Choose one installation method:

npm Global Install:

npm install -g @pair/pair-cli

pnpm Global Install:

pnpm add -g @pair/pair-cli

Manual Install:

• Download pair-cli-manual-vX.Y.Z.zip from GitHub Releases

• Extract to a folder

• Use ./pair-cli (Unix) or pair-cli.cmd (Windows)

• Installation completed without errors

• pair-cli --version shows version number

Step 2: Test Basic Functionality

• pair-cli --help shows help text
• pair-cli install --list-targets shows available asset types

Expected output includes:

Available asset registries:
  github     .github         GitHub workflows and configuration files
  knowledge  .pair            Knowledge base and documentation
  adoption   .pair/product/adopted  Adoption guides and onboarding materials

Sample Project Test

Step 3: Create Test Project

# Create a temporary test directory
mkdir /tmp/pair-test
cd /tmp/pair-test
 
# Create a minimal package.json
echo '{
  "name": "pair-test",
  "version": "1.0.0",
  "scripts": {
    "test": "echo \"Test passed\""
  }
}' > package.json

• Test directory created
• package.json created with test script

Step 4: Run Sample Verification

If you have the sample project available:

# Copy or navigate to sample project
cp -r /path/to/pair/docs/getting-started/sample-project/* .
 
# Run verification
./verify.sh

Expected: Script exits with success (0) and shows sample output.

• Verification script runs successfully
• Output matches expected text

Full Installation Test

Step 5: Install Assets

# In your test directory
pair-cli install

• Command completes without errors
• .pair/ directory created with files
• .github/ directory created (if applicable)

Step 6: Verify Installation

# Check created directories
ls -la .pair/
ls -la .github/
 
# Run any provided tests
npm test  # if package.json has tests

• Directories contain expected files
• No permission errors during access

Cleanup

Step 7: Clean Up Test Environment

# Return to original directory
cd -
 
# Remove test directory
rm -rf /tmp/pair-test

• Test environment cleaned up
• No leftover files or processes

Validation Summary

Date Completed: ______

Installation Method Used: ______

Issues Encountered: ______

Success Rating: [ ] Full Success [ ] Minor Issues [ ] Major Issues

Notes/Feedback:

• What worked well: ______
• What was confusing: ______
• Suggestions for improvement: ______

Overall Assessment: [ ] Ready for production use [ ] Needs fixes [ ] Not usable

Next Steps

If everything worked:

• Start using pair-cli in your actual projects
• Check CLI Workflows for advanced usage
• Join the community at GitHub Discussions

If issues occurred:

• Review the Troubleshooting Guide
• File an issue at GitHub Issues