Open Source MIT License v0.x
Technical Education for the AI Era

Coding5s
Learn With AI.
Don’t Outsource Your Thinking.

An open-source framework for technical learning built around Controlled Cognitive Friction, a five-stage learning lifecycle, Socratic AI mentors, and persistent learning architectures.

coding5s-framework / architecture
# Learning architecture initialized
framework = Coding5s
principle = controlled_cognitive_friction

# Five-stage learning lifecycle
Practice Debug Complete Refactor Extend

ai_role = cognitive_partner
student_role = active_engineer
PILLAR 01 5-Stage Learning Architecture
PILLAR 02 AI Mentor Swarm
PILLAR 03 Stateful5s
The Problem

AI Made Learning Easier.
It Also Made It Easier to Fake.

Tutorial Hell was only the beginning. Generative AI can now produce working code in seconds, allowing learners to reach the output without developing the reasoning required to understand, diagnose, or defend it.

PROBLEM 01

Passive Consumption

Tutorials, videos, and walkthroughs can create the feeling of understanding while someone else performs the actual problem-solving.

PROBLEM 02

AI Outsourcing

The learner can now skip even the attempt. Describe the task, paste the error, and let an AI generate the implementation before a real mental model is formed.

CONSEQUENCE

Epistemic Debt

The gap between what you can produce and what you can actually understand, audit, repair, and extend keeps growing.

The New Learning Problem

When AI can generate the answer instantly, access to the solution is no longer the scarce skill. The scarce skill is the ability to reason about that solution without surrendering your judgment to the machine.

Core Philosophy

The Goal Isn’t to Remove AI.
It’s to Change Its Role.

Coding5s does not fight AI-assisted learning. It restructures it. Instead of allowing the model to perform the student’s cognitive work, the framework introduces deliberate constraints that keep reasoning, diagnosis, and decision-making in the learner’s hands.

Controlled Cognitive Friction

Learning should not optimize for reaching the answer as quickly as possible. It should preserve enough cognitive resistance for the learner to build the mental models required to understand what they are doing.

Capability AI Assistance
+
Constraint Controlled Friction
=
Outcome Active Learning
PRINCIPLE 01
>_

Attempt Before Assistance

The learner interacts with the problem before delegating it to AI. Writing, testing, and observing creates the technical context needed for meaningful guidance.

PRINCIPLE 02
?

Explain Before Receiving

AI mentors can require the learner to articulate what they believe is happening first. The student’s mental model becomes part of the learning process.

PRINCIPLE 03

Repair Instead of Replace

Errors are not removed from the experience. Learners diagnose, correct, refactor, and extend existing systems so that failure becomes technical information.

Controlled Cognitive Friction is not a single exercise. It is enforced through the architecture of Coding5s — three interconnected pillars designed to control progression, AI behavior, and learning state.

Framework Architecture

One Framework.
Three Architectural Pillars.

Coding5s combines three interconnected systems: one structures how the learner progresses, one governs how AI is allowed to help, and one preserves what has already been built.

Core Ecosystem Coding5s Framework Architecture
PILLAR 01

5-Stage Learning Architecture

Curriculum & Learning Lifecycle

Structures technical learning as a progressive engineering lifecycle. The learner moves from initial fluency to debugging, implementation, optimization, and finally architectural expansion.

  • Practice
  • Debug
  • Complete
  • Refactor
  • Extend
PILLAR 02

AI Mentor Swarm

Socratic Behavioral Layer

Specialized AI mentor prompts replace the default answer-first behavior of generic assistants with Socratic guidance, cognitive gates, and controlled intervention.

  • Socratic Feedback
  • No Keyboard Rule
  • Explanation Gates
  • Adaptive Mentor Roles
  • Anti-Spooning Constraints
PILLAR 03

Stateful5s

Persistent Cumulative State

Extends Coding5s into long-running technical environments where every lesson depends on previous decisions. An external Accumulated Context preserves architectural state across the learning sequence.

  • Architectural Ledger
  • Accumulated Context
  • Sequential State Tracking
  • Deterministic Environments
  • Long-Running Technical Labs
The Architecture Working Together
Structured Curriculum
Active Learner
Socratic AI Mentor
Persistent State
Pillar 01

The 5-Stage Learning Architecture

Coding5s does not treat learning as a collection of disconnected exercises. Each topic moves through a structured progression that gradually shifts the learner from guided syntax acquisition to independent architectural reasoning.

The Learning Lifecycle
01
Practice
02
Debug
03
Complete
04
Refactor
05
Extend
Stage 01

Practice

Analogic Syntax Imprinting

The learner encounters a focused concept, studies a working reference, and manually reconstructs the code in their own environment. AI intervention is intentionally limited so the student first builds syntax familiarity and a concrete mental model.

Cognitive Goal Build baseline technical fluency before abstraction and assistance increase.
Stage 02

Debug

Brownfield Triage & Error Isolation

The learner receives intentionally broken code and must isolate syntax, runtime, or logical failures. The goal is not simply to make the program work again, but to understand where the failure originated and how it propagated.

Cognitive Goal Build debugging intuition and compiler empathy through deliberate failure analysis.
Stage 03

Complete

Semantic Isolation & Logic Ingestion

A valid application scaffold is provided, but critical transformation logic has been removed. Inputs, outputs, and structure remain visible; the learner must derive and implement the missing logic instead of starting from a blank page.

Cognitive Goal Convert conceptual understanding into working implementation without outsourcing the core logic.
Stage 04

Refactor

Optimization & Quality Hardening

The code already works. Now the learner must improve it without changing its expected behavior. Attention shifts toward idiomatic patterns, maintainability, edge cases, complexity, and technical debt reduction.

Cognitive Goal Learn that functional code is only the beginning of professional software engineering.
Stage 05

Extend

System Scaling & Architectural Defense

New requirements are introduced into the verified system. The learner must design the extension, implement it, consider scalability and risk, and defend architectural decisions rather than merely reproduce an existing solution.

Cognitive Goal Transition from implementing code to reasoning like a software engineer.
Progressive Transfer of Responsibility

The learner begins with a working reference and ends by making and defending architectural decisions. Across the five stages, support decreases while cognitive ownership increases.

Pillar 02

AI That Helps You Think.
Not Think for You.

Generic AI assistants are optimized to be helpful. Coding5s Mentors are optimized to preserve cognitive ownership. They guide, question, challenge, and analyze without automatically replacing the learner’s reasoning.

Generic AI Assistant answer-first
Student
My code is broken. Can you fix it?
AI
Sure. Here is the corrected code and the complete solution.
VS
Coding5s Mentor friction-controlled
Student
My code is broken. Can you fix it?
Mentor
Before we touch the code: what did you expect to happen, what actually happened, and where do you think the failure begins?
Mentor Anatomy

Behavioral Constraints Built Into the Prompt

Each mentor uses explicit rules that reshape the default behavior of the LLM and control when, how, and how much assistance can be provided.

?

Socratic Feedback

Instead of immediately providing the answer, the mentor uses questions, analogies, and guided deduction to expose gaps in the learner’s mental model.

No Keyboard Rule

During diagnostic phases, the mentor can be explicitly forbidden from writing the corrected implementation. The learner keeps control of the keyboard.

||

Explanation Gates

Passive submissions can trigger a hard stop. Before assistance continues, the learner may need to explain what they tried, what they observed, and what they believe is happening.

Adaptive Mentor Roles

Different mentors can adapt to the learner’s technical level, language, context, and current stage while preserving the pedagogical constraints of the framework.

The Swarm

Different Problems Require Different Mentors

Coding5s treats mentors as modular behavioral architectures. A debugging mentor should not behave like an architecture reviewer, and a paradigm translator should not behave like a beginner tutor.

extensible
Stage Mentors practice / debug / complete / refactor / extend
Paradigm Bridge language and mental-model transitions
Legacy Architect brownfield reverse engineering
Pillar 03

Learning That Remembers What You Built

Some technical environments cannot be taught as isolated exercises. Every new decision depends on what already exists. Stateful5s externalizes that history into a persistent technical state that can be carried forward across the entire learning sequence.

Stateless Learning

The Context Amnesia Problem

Long-running conversations eventually become difficult to reason about reliably. Earlier interfaces, topology, configuration choices, or architectural constraints can be forgotten, duplicated, or contradicted.

Stateful5s

State Outside the Chat

Instead of asking the model to remember everything, Coding5s consolidates the relevant technical history into an Accumulated Context that becomes part of the next learning operation.

stateful5s / cumulative-state-engine
Persistent State Lifecycle
Input Current Lesson
+
State Engine Accumulated Context
Evaluation LLM Reasoning
Commit New Technical State
Lesson N update ledger Lesson N+1 update ledger
Architectural Invariants

What Stateful5s Is Designed to Preserve

The state engine exists to keep sequential learning technically coherent even as the environment becomes increasingly complex.

Cumulative Continuity

Each lesson can inherit the relevant decisions, configurations, and constraints established in previous lessons instead of beginning from zero.

Deterministic Context

The next task can be generated against the actual environment the learner has built, reducing contradictions and invented components.

External State Control

Critical state is managed outside the conversational memory of the LLM, giving the creator a concrete source of truth that can be inspected and updated.

Designed for Sequential Environments

When Yesterday’s Decisions Change Tomorrow’s Problem

Stateful5s becomes useful whenever lessons mutate a persistent technical environment. The learner is no longer solving independent exercises — they are progressively modifying a system whose history matters.

Reference Validation

CCNA / Cisco Packet Tracer

The framework has been used to track cumulative networking state where routers, switches, VLANs, interfaces, addressing, and routing decisions established earlier affect later lessons.

topology VLANs routing interfaces accumulated state
Open Source Toolkit

Not Just a Method.
An Implemented Framework.

Coding5s is published as an inspectable, modifiable open-source project. The repository contains the architectures, generation tools, mentor prompts, learning assets, documentation, and reference implementations used to put the methodology into practice.

github.com/WilfredoBarrios/coding5s-framework
coding5s-framework/
├── pillar_1/
│   └── creator_kits / learning architecture
├── pillar_2/
│   └── mentor swarm / system prompts
├── pillar_3/
│   └── Stateful5s / persistent-state tooling
├── docs/
│   └── methodology / architecture / guides
├── examples/
│   └── reference implementations
└── LICENSE → MIT
TOOLKIT / 01
XLS

Creator Kits

Spreadsheet-based generation engines that help educators and developers build structured Coding5s curricula across the five stages without creating every prompt manually.

TOOLKIT / 02
>_

Student Kits

Learner-facing outputs containing the generated activities and prompts needed to move through the framework without exposing the creator-side generation machinery.

TOOLKIT / 03
AI

Mentor Prompts

Specialized behavioral prompts that transform compatible LLMs into Socratic tutors, reviewers, translators, debugging partners, and architectural challengers.

TOOLKIT / 04

Stateful5s Tooling

Persistent-state workflows and architectural ledgers for technical environments where each new lesson must inherit the state created by previous decisions.

TOOLKIT / 05
DOC

Architecture & Documentation

Methodology specifications, implementation guides, behavioral rules, workflow documentation, and technical explanations describing why and how each component works.

TOOLKIT / 06
LAB

Reference Implementations

Concrete implementations demonstrate how the framework behaves across programming, AI-assisted learning, and cumulative infrastructure environments.

Source Available Now

Inspect the Architecture Yourself

Coding5s does not require you to trust a black box. Read the prompts, inspect the Creator Kits, study the methodology, test the examples, fork the repository, and challenge the design.

Explore GitHub ↗
Framework Implementations

One Architecture.
Multiple Technical Ecosystems.

Coding5s is not tied to one programming language, library, or paradigm. The framework has already been instantiated across multiple technical ecosystems to test how the same five-stage architecture adapts to different ways of thinking about software.

</>
Architecture Over Content

The implementation changes with the technology. The learning architecture does not. Syntax, paradigms, libraries, tooling, and technical constraints are mapped into the same Coding5s lifecycle.

D
Implemented

Dart

language ecosystem

A multi-track implementation covering the progression from language foundations through object-oriented design and into asynchronous and concurrent programming.

Creator Kits
Fundamentals OOP & Advanced Patterns Concurrency & Asynchrony
EX
Implemented

Elixir

functional / BEAM ecosystem

Tests the framework across a radically different programming model built around immutability, pattern matching, functional pipelines, concurrency, and fault-tolerant system design.

Creator Kits
Elixir Fundamentals Elixir OTP
PY
Implemented

Python

language + library ecosystem

The broadest current implementation, spanning core programming, object-oriented design, HTTP workflows, and data-oriented libraries under technology-specific rule sets.

Creator Kits
Core & Scripting OOP HTTPX Requests NumPy Pandas
NET
Reference Lab

CCNA / Packet Tracer

Stateful5s implementation

A cumulative infrastructure implementation used to validate Stateful5s in an environment where topology, interfaces, addressing, VLANs, routing, and previous configurations must persist across lessons.

Architecture Assets
Stateful Creator Kit Accumulated Context Sequential Lessons Packet Tracer
CODING5S CREATOR KIT ARCHITECTURE reusable generation pipeline
Input Target Technology
Engine Coding5s Rules
Output 5-Stage Curriculum

These implementations are not the boundary of Coding5s. They are reference points showing how the framework can be mapped into different technical domains and paradigms.

Browse Creator Kits on GitHub ↗
Built for Access

Low Barrier to Entry.
No Low Ceiling.

Coding5s was designed so that access to the framework does not depend on deploying a platform or becoming a prompt engineer. A Creator Kit turns the underlying architecture into a familiar spreadsheet interface that people can download, inspect, adapt, and use locally.

The Accessibility Principle

A sophisticated learning architecture should not require sophisticated infrastructure. The complexity belongs inside the framework — not in the learner’s path to accessing it.

From Repository to Learning Environment
Step 01 Download a Kit
Step 02 Open the Spreadsheet
Step 03 Adapt the Learning Path
Step 04 Learn or Build a Course
XLS

No Compilation Required

Creator Kits expose the framework through a spreadsheet-based interface. Users do not need to compile an application, deploy a backend, or understand the internal prompt architecture before they can begin working with the system.

AI

Model-Agnostic

Coding5s is an interaction architecture rather than a proprietary AI platform. The methodology can operate with compatible conversational LLMs instead of forcing learners into one provider.

A→Z

Language & Stack Adaptable

The same framework can be mapped into different programming languages, libraries, paradigms, and human-language learning contexts while preserving technical constraints and pedagogical structure.

Accessible Does Not Mean Basic

A beginner can use the interface without understanding its internals, while advanced learners and experienced developers can work with OOP, concurrency, OTP architectures, refactoring, system design, and other high-complexity domains.

Same Framework · Different Depth

From First Syntax to Architectural Reasoning

Coding5s is designed around progressive cognitive responsibility rather than a fixed definition of what an “advanced” learner should be.

New Learner syntax · concepts · practice
Independent Developer debugging · implementation · refactoring
Advanced Engineer architecture · trade-offs · scaling · defense
Who Is Coding5s For?

One Framework.
Different Ways to Use It.

Coding5s separates the learning architecture from the person using it. You can enter the ecosystem as a learner, an educator, an experienced developer, or a researcher and interact with the same underlying framework from a different level of abstraction.

>_
User / 01

Learners

Learn without outsourcing the thinking.

Use ready-made Student Kits to study a technical subject through progressive practice, debugging, implementation, refactoring, and extension. The framework keeps AI available while preventing it from becoming a substitute for technical understanding.

Typical Use
Student Kits AI Mentors Self-Study Progressive Practice
EDU
User / 02

Educators

Turn a syllabus into an active learning system.

Use Creator Kits to define topics, levels, languages, and technical constraints while the spreadsheet generation architecture produces the structured learning payloads. You do not need to manually engineer every prompt or build a software platform first.

Typical Use
Creator Kits Curriculum Design Student Kits Localization
DEV
User / 03

Developers & Technical Teams

Build deeper technical capability, not just syntax.

Coding5s can be adapted to advanced stacks, libraries, paradigms, internal tools, legacy systems, or engineering workflows. Senior practitioners can use the same architecture for brownfield analysis, refactoring, system design, concurrency, scalability, and architectural reasoning.

Typical Use
Advanced Creator Kits Legacy Analysis Architecture Team Training
R&D
User / 04

Researchers & Institutions

Inspect, test, measure, challenge, and extend.

Because the framework is open source, its assumptions, prompt architectures, learning constraints, localization mechanisms, and state-management techniques can be independently studied and modified rather than hidden behind a proprietary educational platform.

Typical Use
Methodology Experimentation AI Education Framework Extensions

You Do Not Need to Use Every Layer

The ecosystem can expose complexity progressively. Someone can simply study from a generated Student Kit, while another person can go deeper and modify the architectures that generated it.

Consume Use a Student Kit
Create Build With a Creator Kit
Extend Modify the Framework
Global by Architecture

The Learning Language Is a Configurable Layer

Creator Kits can generate learning experiences in different human languages from the same underlying curriculum architecture. For language environments where generic LLM translation is not enough, Coding5s can add specialized semantic context layers designed to preserve technical meaning and improve linguistic adaptation.

Open Source · MIT License

Fork It. Study It.
Improve It.

Coding5s is being developed in the open because technical learning infrastructure should be something people can inspect, adapt, challenge, translate, extend, and build upon — not simply consume.

Open Source as an Architectural Decision

Democratizing technical education requires more than publishing free content. It requires giving people access to the machinery that creates the learning experience itself.

LICENSE: MIT

Built to Be Reused

The framework is released under the MIT License, enabling individuals, educators, institutions, and companies to use and modify the project subject to the license terms.

What That Enables

Coding5s can become a starting point rather than an endpoint. The architecture can be adapted to different learning environments and technical needs.

Use
Modify
Distribute
Publish
Adapt
Build Upon

Fork the Framework

Create your own branch of Coding5s and adapt the architecture to a technology, organization, educational context, or experimental use case.

Audit the Method

Inspect the actual prompts, rules, spreadsheets, workflows, and specifications instead of relying on marketing claims or a hidden platform.

+1

Improve the Architecture

Identify weaknesses, propose better constraints, improve Creator Kits, refine documentation, or contribute new technical implementations.

🌐

Adapt It Locally

Communities can adapt learning experiences to their own technical stacks, languages, educational realities, and local constraints without waiting for a centralized platform to support them.

Community Development

You Don’t Need Permission to Experiment

Coding5s is still evolving. Contributions do not have to begin with a massive pull request. Testing an idea, reporting a problem, challenging an assumption, or documenting a better approach can all move the framework forward.

CONTRIBUTE / 01

Report What Breaks

Bugs, confusing workflows, weak prompts, edge cases, and implementation problems are useful engineering information.

CONTRIBUTE / 02

Challenge the Design

Question assumptions, propose alternative architectures, compare approaches, and test whether the methodology behaves as intended.

CONTRIBUTE / 03

Build Something New

Extend the framework into new technologies, educational contexts, languages, workflows, tooling, or entirely new implementation patterns.

The repository is the technical source of truth. Explore it directly, inspect the implementation, and participate in its evolution.

>_ source_of_truth = github.com/WilfredoBarrios/coding5s-framework
Build With Us

Coding5s Is Open.
Its Next Version Is Not Finished.

The framework is evolving through implementation, experimentation, and real-world use. Developers, educators, learners, researchers, and language communities can help test its assumptions and expand what the architecture can do.

PARTICIPATE / 01

Use It

Download the available kits, study with them, generate a learning path, or adapt Coding5s to something you already want to learn or teach.

PARTICIPATE / 02

Test It

Push the framework into new languages, stacks, environments, learner profiles, and technical difficulty levels. Find where the architecture fails.

PARTICIPATE / 03

Improve It

Open an issue, start a discussion, propose an architectural change, improve documentation, or contribute an implementation of your own.

The Coding5s Framework

Technical Education Changed.
The Way We Learn Must Change With It.

AI can write more code than ever before. Coding5s is an open-source attempt to make sure humans continue learning how to understand, question, repair, and architect what those systems produce.

Open Source · MIT Licensed · Model-Agnostic · Community Extensible
> framework.status = open  ·  next_step = build_with_it
Scroll to Top