AGENTS.md

Guidance for coding agents working on LMSSEP ASCII Flow MCP Server. This server generates ASCII diagrams for process flow, code structure, logic analysis, and project schedules.

Project overview

The ASCII Flow server exposes flowchart generation, code structure analysis, logic-flow analysis, and master schedule generation. It is useful for documentation, code review notes, and lightweight technical diagrams that fit in Markdown.

Setup commands

bashcd <project-root>/genesis/LMSSEP/asciiflow
pip install -r requirements.txt
python3 main.py

Edit configs/asciiflow.py to customize diagram width, box styles, output directories, and analysis limits.

Tool map

• generate_linear_flowchart creates linear or branching process diagrams.
• analyze_code_structure visualizes functions, classes, and relationships.
• analyze_logic_flow analyzes conditionals, loops, and complexity.
• generate_master_schedule creates horizontal timeline schedules.

Output handling

Generated diagrams are saved under output/diagrams/. Treat them as generated artifacts. Commit only curated examples, not every run output.

Testing and verification

Verify one simple flowchart, one code structure diagram, one logic-flow diagram, and one schedule. Use small synthetic examples so snapshot differences are readable. Check that long labels wrap or truncate cleanly inside the configured width.

Security and content handling

Code snippets and process descriptions may include private logic. Redact secrets before diagram generation and before publishing outputs. Do not execute code supplied for structure or logic analysis.

Commit and PR rules

When changing rendering logic, include examples for linear, branching, code, and schedule output. Keep formatting deterministic so review diffs stay useful.