ADR stands for Architecture Decision Record. It's a critical aspect of producing well-designed code using GenAI (in my case I use Claude Code). The idea of an ADR is to capture something platform-sized. Something that improves the overall code base plus the developer and author experience. Hopefully, someone

Sharpee has it's own home outside of github now. Visit https://sharpee.net/. There are quick start and author guides along with the beta port of Mainframe Zork aka Dungeon. The platform is also in beta and can be used to create stories. I only have the thin

In the last week I've been play-testing the port of Dungeon which has exposed many things about Sharpee and the Dungeon implementation. Many many things. Just the first ten to twenty turns of Dungeon have uncovered a lot of issues. The troll logic is actually quite complicated. Had

White Paper on Sharpee Interactive Fiction Engine January 2026 Abstract Sharpee's Capability Dispatch system solves a fundamental problem in extensible software: how do you allow third-party code to modify the behavior of standard operations without sub-classing, monkey-patching, or invasive hooks? This paper describes a pattern combining double dispatch,

Classic IF Systems and Sharpee A detailed comparison of how TADS, Inform 6, Inform 7, Hugo, and Sharpee handle the journey from player input to executed action. Overview All parser-based IF systems solve the same fundamental problem: transform natural language input into game actions. The solutions share common ancestry but

In the process of porting Dungeo to Sharpee, we got to a completed implementation, but some unit tests missed important steps. When I started a "walkthrough" test in phases, we discovered a glaring gap in my grammar and parser implementation. I should say fundamental misunderstanding of what the

The port of mainframe Zork is nearly complete, but I keep running into things that impact the platform so I get sidetracked into improving Sharpee over finishing Dungeo. Scoring The most recent refactor from the port of Zork was how we enable scoring in the platform and how the author

It took all night to get it right (I'm new to npm publishing), but a beta version of Sharpee is now available: npm install @sharpee/sharpee@beta This is a standalone release of the primary eleven packages authors will use to develop stories, though the current text-service and

Updated: Jan 2, 2026 Even though I had designed and implemented a robust grammar and parser system for Sharpee, many standard use cases were not implemented. In the process of porting mainframe Zork, the grammar for INCANT x y (raw text in both cases) exposed a severe weakness in my