ALI RAZA
Contact
03Education · Platform · 2026

Code-Yaar

Think. Build. Evolve. — a software engineering education platform, currently in disciplined definition phase.

Status
Documentation phase
Year
2026
Role
Product definition, requirements, architecture planning, and progress-tracking system.

01Problem

Many learners consume programming content without developing practical ability: tutorial dependence, limited project practice, weak problem-solving confidence, unclear next steps, and difficulty producing credible evidence of skill.

Most education platforms promise outcomes they cannot prove. Starting Code-Yaar with an honest status system prevents that pattern from day one.

02Solution

Write the PRD, architecture, and roadmap first — scope drift is prevented by an approved MVP definition before any foundation work.

Define a strict status vocabulary (Implemented / Verified / In Progress / Planned / Proposed / Deferred / Not Implemented / TBD) so every future claim must carry evidence.

Center the product on one loop: Learn → Build → Prove — learning direction, hands-on practice, project work, proof of work, feedback, progression.

03Implementation

Keep explicit non-goals: not a university replacement, not a social network, not a course marketplace, not a recruitment platform, not a full IDE.

03ATechnical flow

Planned product loop (proposed — no code yet)
  1. Learning Direction

    What to learn next

  2. Learn

    Guided content and concepts

  3. Build

    Hands-on practice and projects

  4. Prove

    Proof of work / portfolio evidence

  5. Feedback & Progression

    Review and next step

04Technology

  • Product documentation
  • PRD
  • Architecture planning
  • MVP roadmap
  • Status tracking

Note — Target direction recorded in docs: Python, Next.js/React/TypeScript, Django, PostgreSQL, Supabase — no code exists yet.

05Features

  • 01Product Requirements Document (v0.1, Draft) — problem framing, personas, user needs, value proposition, and functional requirements.
  • 02Architecture document — records intended stack direction and states plainly what does not yet exist.
  • 03MVP roadmap — four phases (Foundation → MVP → Validation → Expansion) with priorities, dependencies, and completion criteria.
  • 04Current-progress report — a source-of-truth status table with evidence columns as observed on 2026-09-10.
  • 05AI coding rules — boundaries for AI-assisted development on the project.

06Visual evidence

No verified screenshot or recording is attached to this project record yet. The working interaction below is the available local evidence.

Working demo

Learning progression preview

Move a learner from practice to build to proof of work.

Local interaction · no fake API response

Current learner stage: Practice

07Links

GitHub ↗Live demo not available

AProject state

Implemented

  • Five-document product suite: PRD, architecture, MVP roadmap, current progress, AI coding rules.
  • Status vocabulary and evidence-based progress tracking.
  • Explicit MVP non-goals and scope exclusions.

In progress

  • MVP definition and primary persona decision (flagged P0, awaiting product-owner decision).
  • Architecture and stack decisions — direction recorded, nothing implemented.

Planned

  • Repository foundation: source layout, package setup, basic checks.
  • Learner entry point, first learning direction, hands-on practice, one meaningful build workflow, basic proof of work.
  • Automated verification: tests, linting, type checking, build checks.
  • Feedback workflow, progression tracking, community and AI assistance (post-MVP, proposed).

BEngineering decisions

  1. D01

    Documentation before code

    The first commit is a plan, not scaffolding. CURRENT-PROGRESS.md states honestly that no product feature exists in the codebase — planned work is never dressed up as shipped.

  2. D02

    Evidence columns

    Every status entry records where the claim is proven (which file, which test). A feature is only "Implemented" when code exists for it.

  3. D03

    Named non-goals

    University replacement, social network, course marketplace, recruitment platform, full IDE, and broad AI platform are explicitly excluded from initial scope.

  4. D04

    No dates until they are real

    The roadmap carries no deadlines because none have been decided — false dates create false pressure and dishonest reporting.

CChallenges

  1. C01

    Resisting premature scaffolding

    The temptation with a platform idea is to create repositories and boilerplate immediately. The project instead holds until MVP scope is approved.

  2. C02

    Keeping honesty as the brand

    An education platform that overstates its own progress would contradict its own message — the status vocabulary exists to make overstatement structurally impossible.

DResult

  • Complete, reviewed product documentation suite published publicly on GitHub.
  • A measurable baseline: anyone can compare future progress against the 2026-09-10 status report.
  • Clear MVP definition work queued as P0 with acceptance criteria — before any implementation begins.

EWhat I learned

  • “Writing "no product feature exists" in your own progress report is the most credible thing a pre-launch project can do.”
  • “A status vocabulary is an engineering tool — it turns future progress claims into checkable assertions.”
  • “Scope discipline (what the product is not) defines a project faster than feature lists.”