Project Story: Code Track Map

directory layout and purpose of each section

About Code Repo

5.  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. Code track directories are accessible from github using the "Code Repo" link in the page header.

5.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/ProjectStory_*.html  (10) Project 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.

5.2  Top-Level Directories

Path Description
Code/AI/ All Python-based AI demo agents, API examples, analysis scripts, and reusable skill modules. See section 5.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 (ProjectStoryPages.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.

5.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.