jupytext: text_representation: extension: .md format_name: myst format_version: 0.13 jupytext_version: 1.19.1 kernelspec: name: bash display_name: Bash language: bash options: type: source¶

title: Evidence Sources author: Vadim Rudakov, rudakow.wadim@gmail.com date: 2026-03-07 options: type: guide version: 0.1.0 birth: 2026-03-07 token_size: 761¶

This directory holds ephemeral source material --- dialogue transcripts, meeting notes, and raw research inputs --- that feed into analyses (evidence/analyses/) and ultimately produce ADRs (decisions/).

Lifecycle¶

Sources follow a three-commit workflow:

Commit 1 --- Capture: Add the transcript to evidence/sources/S-YYNNN_slug.md
Commit 2 --- Extract: Write the analysis to evidence/analyses/A-YYNNN_slug.md with sources: [S-YYNNN]. Update the source’s extracted_into field to point at the analysis.
Commit 3 --- Delete: Remove the source file. Git history preserves it at a predictable path.

Rule: A source is only deleted AFTER its extracted_into field points to a committed analysis.

The commit 1 and 2 can be combined into 1 commit if the analysis is done in the same session when the source is saved.

Naming Convention¶

S-YYNNN_descriptive_slug.md where:

S = Source namespace prefix
YY = Two-digit year (e.g., 26 for 2026)
NNN = Sequential number within the year (e.g., 001)
_descriptive_slug = Kebab-style description

Frontmatter Schema¶


title: Claude — AKB Taxonomy Discussion
date: 2026-02-26
options:
  id: S-26001
  model: claude-opus-4
  extracted_into: A-26001
  type: source
---

Git Archaeology¶

Sources are designed to be committed and then deleted. The git history preserves them permanently at predictable paths.

Get the list of all source files in Git history:

cd ../../../
ls

0_intro       CLAUDE.md       LICENSE.md      README.md         uv.lock
ai_system     CONVENTIONS.md  misc            RELEASE_NOTES.md
architecture  draft           mlops           security
_build        LICENSE-CODE    myst.yml        todo
CHANGELOG.md  LICENSE-DOCS    pyproject.toml  tools

sources="architecture/evidence/sources/"; git log --oneline --name-only -- "${sources}" | grep  "${sources}" | grep -v "${sources}/README.md" | sort -u | tail -n3

architecture/evidence/sources/README.md
architecture/evidence/sources/S-26001_gemini_dialogue_skills_architectures.md
architecture/evidence/sources/S-26002_gemini_changelog_alternatives_analysis.md
architecture/evidence/sources/S-26003_gemini_post_commit_hook_stage_advice.md
architecture/evidence/sources/S-26004_gemini_semantic_alignment_assessment.md
architecture/evidence/sources/S-26005_qwen_agentic_os_architecture_diagram.md

Search for deleted transcripts:

git log --all --full-history -- architecture/evidence/sources/ | head -n20

commit 8d0b38ccd6ab6567672043ba74aebce332875bf0
Author: Vadim Rudakov <lefthand67@yandex.ru>
Date:   Fri Mar 6 20:22:18 2026 +0500

    docs: Delete extracted evidence sources (three-commit workflow, step 3)
    
    - Deleted: architecture/evidence/sources/S-26001_gemini_dialogue_skills_architectures.md — extracted_into: A-26002
    - Deleted: architecture/evidence/sources/S-26002_gemini_changelog_alternatives_analysis.md — extracted_into: ADR-26024
    - Deleted: architecture/evidence/sources/S-26003_gemini_post_commit_hook_stage_advice.md — extracted_into: A-26004
    - Deleted: architecture/evidence/sources/S-26004_gemini_semantic_alignment_assessment.md — extracted_into: A-26005
    - Deleted: architecture/evidence/sources/S-26005_qwen_agentic_os_architecture_diagram.md — extracted_into: A-26005
    
    Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

commit bfcf9c78b035466c542af054e35512e7eb4b3e0b
Author: Vadim Rudakov <lefthand67@yandex.ru>
Date:   Fri Mar 6 20:18:28 2026 +0500

    docs: Add Document Type Interfaces analysis and formalize evidence sources

Recover a specific deleted transcript:

git show <commit-hash>:architecture/evidence/sources/S-YYNNN_slug.md

Find which commit deleted a file:

git log --diff-filter=D -- architecture/evidence/sources/S-26001_slug.md