Skip to content

KyPython/readiness-checklist-tool

Repository files navigation

Project Readiness Assessment Tool

A web-based tool to evaluate whether a project is ready to start, helping teams identify gaps in planning, requirements, resources, and risk mitigation before beginning execution.

"Not Until You're Ready" - This tool embodies the principle that it's better to delay a project start to address critical gaps than to rush into execution with unresolved issues.

Features

  • Interactive Assessment: Answer 24 questions across 4 key categories
  • Visual Scoring: Rate each question on a 1-5 scale (Very Poor to Excellent)
  • Comprehensive Analysis: Get detailed results with category breakdowns
  • Actionable Recommendations: Receive specific guidance on areas needing attention
  • Clear Status: Know if your project is Ready, Needs Clarification, or Not Ready

Categories

  1. Requirements Clarity - Assess the clarity and completeness of project requirements
  2. Technical Feasibility - Evaluate technical readiness and feasibility
  3. Team & Resources - Check team availability and resource allocation
  4. Risks & Mitigations - Identify risks and assess mitigation strategies

Getting Started

Prerequisites

  • Node.js 18+ and npm

Installation

  1. Clone or download this repository
  2. Install dependencies:
npm install

Development

Run the development server:

npm run dev

Open http://localhost:5173 in your browser.

Build

Create a production build:

npm run build

Preview the production build:

npm run preview

How to Use

  1. Start Assessment: The tool presents questions organized by category
  2. Answer Questions: Click the numbered buttons (1-5) to score each question:
    • 1 = Very Poor
    • 2 = Poor
    • 3 = Fair
    • 4 = Good
    • 5 = Excellent
  3. Complete All Questions: Answer all 24 questions to proceed
  4. View Results: Get your readiness status and detailed breakdown
  5. Review Recommendations: Address areas flagged for improvement

Scoring System

Overall Status

  • Ready (4.0-5.0): Project appears ready to start. All critical areas are well-defined.
  • Needs Clarification (3.0-3.9): Project has potential but requires clarification in some areas before starting.
  • Not Ready (<3.0): Significant gaps exist. Address critical issues before proceeding.

Category Scores

Each category is scored independently. Categories scoring below 3.5 indicate areas needing attention and will generate specific recommendations.

Checklist

See CHECKLIST.md for the complete list of questions and detailed scoring guidelines.

Technology Stack

  • React 18 - UI framework
  • TypeScript - Type safety
  • Vite - Build tool and dev server
  • CSS3 - Styling with modern features

Project Structure

readiness-checklist-tool/
├── src/
│   ├── components/        # React components
│   │   ├── CategorySection.tsx
│   │   ├── QuestionCard.tsx
│   │   └── ResultsView.tsx
│   ├── utils/            # Utility functions
│   │   └── scoring.ts
│   ├── App.tsx           # Main application
│   ├── App.css           # Application styles
│   ├── checklist.ts      # Checklist data
│   ├── types.ts          # TypeScript types
│   ├── index.css         # Global styles
│   └── main.tsx          # Entry point
├── CHECKLIST.md          # Complete checklist questions
├── README.md             # This file
└── package.json          # Dependencies and scripts

Philosophy: "Not Until You're Ready"

This tool is built on the principle that premature project starts often lead to:

  • Scope creep and unclear objectives
  • Technical debt and rework
  • Resource conflicts and team burnout
  • Unmanaged risks becoming issues
  • Project failures and wasted effort

By systematically evaluating readiness across key dimensions, teams can:

  • ✅ Start with clear requirements and expectations
  • ✅ Identify and address risks proactively
  • ✅ Ensure adequate resources and team availability
  • ✅ Build on a solid technical foundation
  • ✅ Increase the likelihood of project success

Remember: A well-planned delay is better than a poorly-executed start.

Contributing

This is a standalone assessment tool. Feel free to:

  • Customize questions for your organization
  • Add new categories or assessment criteria
  • Integrate with project management tools
  • Extend with reporting and analytics

License

This project is provided as-is for use in project readiness assessments.


Start your assessment today and ensure your project is truly ready before you begin!

Releases

No releases published

Packages

No packages published