Finite Object State Machines

Building Business Software for the AI Age

A hands-on guide to re-think business software from mere CRUD to a lifecycle-driven state machine using Rails 8, FOSM, and your favorite AI Coding Agent

By Abhishek Parolkar

Based on the FOSM paper: “Implementing Human+AI Collaboration Using Finite Object State Machine”

Part I — The Paradigm Shift

1. Why Business Software Is Stuck
2. The FOSM Paradigm
3. AI as the Specification Engine

Part II — The Foundation

1. Rails 8 — The One-Person Framework
2. Base Rails App — The First Wall
3. The FOSM Engine — Core Architecture
4. Your First FOSM Object — The NDA

Part III — Building the Business Platform

1. Partnerships — Multi-Entity Relationships
2. CRM — The Customer Lifecycle
3. Financial Lifecycle — Invoicing & Expenses
4. People Operations — Hiring, Leave, Time Tracking
5. Operations — Projects, Vendors, Inventory, Knowledge Base
6. Strategic Objects — OKRs, Payroll, Feedback
7. The Company Entity — External Data Meets FOSM

Part IV — The FOSM Primitives

1. Primitive 1 — Access Control
2. Primitive 2 — Inbox & Messaging
3. Process Documentation — Code as the Living Document

Part V — AI Integration & Beyond

1. The Bot Architecture
2. Every Module Gets a Bot
3. AI-Powered FOSM — The Full Circle
4. Coda — Where FOSM Goes Next

Appendices

• Appendix A — FOSM Glossary
• Appendix B — The Complete Lifecycle Reference
• Appendix C — The FOSM Paper: Annotated Summary
• Appendix D — Setting Up the Development Environment
• Appendix E — AI Prompt Templates

This book is available as a single LLMs.txt file for use as LLM context.