Code Story

Code Story: Code Track Map

directory layout and purpose of each section

1.  Code Track Map

The Code track lives entirely under Code/. Every file is static - no build step, no server. This page maps every directory and file family so you can locate any resource quickly. The three sections below cover root-level HTML pages, top-level directories, and the AI subfolder in detail.

1.1  Root HTML Pages

All content pages and both explorers sit at the root of Code/.
Path Description
Code/ExploreCode.html Two-panel explorer host for the Code track; wraps all content pages in the left-nav / right-content layout.
Load by clicking [Code] button in top menu.
Code/CodeHome.html Track home page and entry point for the Code explorer.
Code/CodeStory_*.html  (10) Code Story narrative chapters: Prologue through Code Track Map, each a full-page treatment of one topic in the story thread.
Code/AIStory_*.html  (13) AI Story narrative pages: Prologue, Concepts, Models, API, Prompts, Context, Caching, Tokens, Streaming, Output, Reliability, Tools, Agents.
Code/AIBites_*.html  (12) Code Bites reference pages: brief, standalone write-ups covering AI tools, chat bots, LLM API, agent AI, agentic AI, skills, and spec-driven development.
Code/ExploreReposCode.html Explorer for repository overview pages (RepoCode_*.html).
Load by clicking "Repositories" link in left panel.
Code/RepoCode_*.html  (4) Repository overview pages: Summary, Projects, ReadmeAgent, Webifier - each summarizing a repo or tool.

1.2  Top-Level Directories

Path Description
Code/AI/ All Python-based AI demo agents, API examples, analysis scripts, and reusable skill modules. See section 1.3 for detail.
Code/Basics/ Language-agnostic basics folder; currently holds a Hello/ example.
Code/C#/ Fifteen C# demo projects spanning blocking queues, parsers, graph traversal, navigation, WPF, and WCF.
Code/C++/ Five C++ demo projects: Hello, Basics, DirNav, NameConventions, TextFinder.
Code/CodeWebifier/ .NET tool that converts source files to syntax-highlighted HTML for site publication. Build with Visual Studio or dotnet build.
Code/Components/ Custom web components: CodeViewerComponent and ImageViewerComponent.
Code/DesignStructure/ Seven Rust design pattern examples: BasicStructure, DataFlowStructure, FactoredStructure, PlugInDataFlowStructure, PlugInWithTraitObjects, TypeEraseDataFlowStructure, TypeEraseDataFlowStructureWithTraitObjects.
Code/Projects/ Shared multi-language tools: TextFinder and PageValidator, with timing scripts (tf_timer.py, pa_timer.py) and session notes.
Code/Python/ Python Hello examples (Hello.py, FirstHello.py).
Code/Rust/ Rust Hello and Basics examples.
Code/css/ Track-specific stylesheets: Explorer.css, FigureSizer.css, content-links.css, link-nav.css, gridExplorer.css, Styles_Bits.css, Styles_BitsContent.css.
Code/js/ Track-specific JavaScript: page-list builders (CodeStoryPages.js, CodeBitesPages.js, AIStoryPages.js), CodeViewer.js, contentMessages.js, contentElements.js, cookies.js, and navigation helpers.
Code/documents/ PDF documents and analysis text files: AI Skills, AI Agents, AI Chat Bots, AI Consoles, plus code analysis output.
Code/pictures/ Images and SVGs used by content pages: LLM diagrams, neural network SVG, chatbot and agent demo screenshots.
Code/_template_cpp/ C++ project starter template with EntryPoint/, Part1/, Constitution.md, Notes.md, and a new_project.py scaffolder.
Code/_template_csharp/ C# project starter template with the same layout as the C++ template.
Code/_template_python/ Python project starter template with src/, part1/, EntryPoint/, pyproject.toml, requirements.txt, and virtual-env setup notes.
Code/_template_rust/ Rust project starter template with entry_point/, part1/, Cargo.toml, and a new_project.py scaffolder.
Code/archive/ Older or superseded versions of pages and assets, kept for reference.

1.3  AI/ Subdirectories

The AI/ folder is the most actively developed part of the track. Each subdirectory is a self-contained demo or tool. All agents require the ANTHROPIC_API_KEY or equivalent environment variable.
Path Description
AI/DemoAgent-Claude2/ Primary interactive dev agent (dev_agent.py). Commands: /analyze, /improve, /readme, /tree, /files, /clear, /quit. Launch via run_agent.ps1 or run_agent.bat.
AI/DemoAgent-Claude/ Earlier single-pass code analysis agent (CodeAnalysisAgent.py); kept for comparison with the interactive version.
AI/DemoCode-Claude/ Minimal Anthropic SDK call examples showing raw API usage without agent scaffolding.
AI/DemoCode-Gemini/ Direct Google Gemini API call examples, parallel to the Claude demos for direct comparison.
AI/DemoAIConsole-Gemini/ Interactive console that loops on user input and calls the Gemini API, illustrating a minimal chat loop implementation.
AI/DemoLibraryAgent-Claude/ Agent that analyzes a library codebase and produces a structured summary of its public API and design.
AI/ReadmeAgent-Claude/ Agent that generates a README.md from source code and directory structure.
AI/RustDemoAgent-Claude/ Claude agent tuned for Rust code; understands ownership, lifetimes, and crate structure when producing analysis.
AI/RustCodeAnalysis/ Static analysis scripts for Rust projects; produces metric reports on size, complexity, and structure.
AI/CppCodeAnalysis/ Static analysis for C++ projects; CppCodeAnal.html displays results inline in the site.
AI/Skills/ Reusable skill modules imported by agents: file I/O, code extraction, and summarization helpers.
AI/Scripts/ Utility shell and PowerShell scripts for launching agents and managing output files.
AI/Claude/ Context summaries and notes used across Claude API sessions; ContextSummary.md tracks accumulated session state.