AIDLC-VIEWER

What's New

0.0.15

• Accurate stage progress — Inception/Construction/Operations percentages are now counted from .md artifacts under the aidlc-docs/ folder inside the watched root (aidlc-docs/inception/, aidlc-docs/construction/, aidlc-docs/operations/), instead of any path that merely contains a stage word. Selecting the aidlc-docs folder directly still works.
• State-file-based progress — when aidlc-docs/aidlc-state.md exists, progress is read from its ## Stage Progress checklist (the workflow's own record): completed steps count against the number of bundled rule files per stage, and the current in-progress step name is shown next to the stage row. Falls back to the artifact-count estimate when no state file is present (tooltip indicates which source is used).
• Auto-expand new artifacts — folders containing unread NEW files (including newly created folders) start expanded in the tree, so freshly generated artifacts are visible without manual digging.
• Viewer guide rewritten — the help panel is now the "AI-DLC Viewer Guide": an English walkthrough of the viewer's features (progress tracking, live tree, split editor/preview, toolbar) with a Korean version below. It also opens automatically the first time you enter the viewer with no folder being watched.
• Workspace auto-detect — if the open workspace already contains an aidlc-docs/ folder, the extension offers to watch it (asked once per workspace).
• Open in Text Editor — right-click a file in the tree to open it in a regular VS Code editor instead of the split viewer.
• Unread badge — the activity-bar icon shows how many NEW artifacts are waiting to be read.
• Less refresh churn — file-watcher events from ignored directories (.git, node_modules, build output, …) no longer trigger tree refreshes.
• Webview hardening — added a Content-Security-Policy to the Markdown viewer, sanitized link/image URLs (blocks javascript: / data: schemes), tightened HTML attribute escaping, and switched Mermaid to antiscript security level.
• Cleanup on deactivate — watchers and polling timers are now disposed when the extension is deactivated.

0.0.14

• One-click AI-DLC rule setup — click the Set up AI-DLC Rules button in the view toolbar and the extension installs the AI-DLC rule files into your project, so beginners can skip the manual download/copy steps from the aidlc-workflows README.
• Rules are bundled with the extension (snapshot of the awslabs/aidlc-workflows v1.0.0 release) and copied locally — no network access or AI agent required.
• Generates the real per-platform files (not pointers) following each tool's convention:
  • Kiro (always): .kiro/steering/aws-aidlc-rules/ + .kiro/aws-aidlc-rule-details/
  • Claude Code (always): CLAUDE.md + .aidlc-rule-details/
  • Cursor (when host is Cursor): .cursor/rules/ai-dlc-workflow.mdc (with frontmatter) + .aidlc-rule-details/
  • GitHub Copilot (when host is VS Code): .github/copilot-instructions.md + .aidlc-rule-details/
• The extra target is chosen automatically from the host IDE (vscode.env.appName); Kiro and Claude Code are always set up.
• Two ways to trigger — press the Set up AI-DLC Rules toolbar button anytime, or just pick a folder via Watch this folder and confirm the "Set up the AI-DLC workflow for this folder?" prompt. Setup never runs while you are still browsing folders, nor on window reload.
• Idempotent & safe — existing files/folders are detected and skipped, never overwritten.
• New ghost-themed extension icon.

Key Features

AI-DLC generates folders and Markdown artifacts across three lifecycle stages (Inception → Construction → Operations). This extension is purpose-built to track and consume those artifacts:

• Stage-aware artifact tracking — only detects folders and .md files produced by the AI-DLC workflow (inception/, construction/, operations/), ignoring unrelated files and directories.
• Current stage indicator — shows at a glance which AI-DLC stage the project is currently in, based on the most recently updated artifact.
• Overall progress bar — visual progress bar summarizing how far the project has advanced across all three stages.
• Readable Markdown viewer — opens each .md artifact in a split editor with a syntax-colored, prettier-styled preview (color-coded headings, tables, task lists, code blocks) for high readability.
• In-place editing — edit and save changes back to the original .md file directly from the viewer, with a resizable splitter and zoom controls.
• Live change detection — automatically picks up new files and folders created by Claude CLI (or any external process) via file watchers and focus-based refresh.
• Built-in AI-DLC guide — a help panel explaining AI-DLC phases, rules, and generated artifacts, accessible from the view toolbar.

How it works

Minimal VS Code extension prototype for AI-DLC workflow folders:

1. Select a folder to watch.
2. Show live file and directory changes in a tree view.
3. Click a Markdown file to open an editable split viewer.
4. Save changes back to the original .md file.

Run locally

1. Open this folder in VS Code.
2. Press F5 to launch an Extension Development Host.
3. In the new window, open the AIDLC activity bar icon.
4. Run AIDLC-VIEWER: Open Workspace.
5. Choose the AI-DLC project folder your agent is writing into (the one containing aidlc-docs/).

Current scope

• Watches one selected root folder.
• Refreshes tree items when files or directories change.
• Opens .md files in a custom webview with editor + preview.
• Saves edits directly to disk.
• Shows the first Markdown heading in the tree as a quick description.
• Hides folders that do not contain any Markdown files.
• Adds section-friendly directory labels for rule repositories.
• Marks newly created Markdown files with a green NEW indicator.
• Marks opened Markdown files as READ and rolls counts up to parent folders.
• Shows a compact stage summary at the top of the tree with the current stage and stage counts.

Good fit for rule repositories

This works well for AI-DLC repositories and assets such as:

• awslabs/aidlc-workflows assets/images
• ../aidlc-workflows/aidlc-rules

That repository has a nested rules structure such as:

• aws-aidlc-rules/core-workflow.md
• aws-aidlc-rule-details/common/*.md
• aws-aidlc-rule-details/inception/*.md
• aws-aidlc-rule-details/construction/*.md
• aws-aidlc-rule-details/operations/*.md
• aws-aidlc-rule-details/extensions/**/*.md

The extension will show that structure as a live tree and display each Markdown file with an editable preview panel. Directories such as common, inception, construction, operations, and extensions also get clearer icons and summaries in the tree.

Suggested test flow

1. Start the extension with F5.
2. Select an AI-DLC project folder (or any folder with aidlc-docs/inception|construction|operations subfolders containing .md files).
3. Confirm the top row shows the current stage.
4. Open inception/requirements-analysis.md and confirm it becomes READ.
5. Create a new file such as construction/new-task.md and confirm it appears as green NEW.
6. Open that new file and confirm NEW changes to READ.
7. Edit operations/review-checklist.md, save it, and confirm the stage row moves to Operations.
8. Edit construction/functional-design.md, save it, and confirm the stage row moves back to Construction.