The Analyst's Second Brain: Notes That Answer Questions Months Later
Written by Ahmed at Analyst Engineering, a Senior Technical Business Analyst with 10+ years in banking and payments delivery.
Key takeaways
- An analyst's second brain is not a note archive, it is a query-able record of how systems behave and why decisions were made. If it cannot answer a question in under two minutes, it is a graveyard.
- Organize by system and decision, never by date or meeting. The question you will ask in six months is 'why does the settlement batch cut at 15:30', not 'what did we discuss on 14 March'.
- Four note types carry almost all the value: system notes, decision records, incident notes, and field notes. Everything else is a draft that should have been one of those four.
- Plain Markdown files in a git repository beat any proprietary tool: they diff, they survive tool migrations, they are greppable, and they are the format AI assistants read best when you attach them as grounding.
- The compounding effect is the point. Two years of decision records makes you the person who knows why the system is the way it is, and that knowledge is what makes an analyst hard to replace.
An analyst’s second brain is a searchable record of how your systems behave and why the decisions were made, organized by system and decision rather than by meeting date, written in plain Markdown, and kept in version control. Its only test: can it answer a real question in under two minutes.
A second brain for a technical analyst is not a note-taking habit. It is an external, query-able memory of system behavior and decision history, built from four note types, stored as plain Markdown files in a git repository, and organized by the subject of the question rather than the date of the meeting. The reason to build one is narrow and practical: the highest-value questions in delivery are “why does it work like this” and “what happened last time,” and the answers decay out of human memory in about six weeks while the systems live for fifteen years.
I learned this the expensive way on a payments programme. Someone asked why our repair queue re-validated the full message instead of just the corrected field. The answer existed: it had been decided in a meeting eighteen months earlier, for a real regulatory reason, by people who had since moved on. Reconstructing it took three days of reading old email threads. The note that would have answered it in ten seconds would have taken ten minutes to write. That ratio is the entire argument, and it is why a second brain belongs in the same category of analyst leverage as the AI flows in the AI-augmented analyst workflow rather than in the category of productivity hobbies.
Why do most analyst note systems fail?
They fail for one structural reason: they are organized by date and source instead of by subject. A folder of files called 2026-03-14 payments sync and weekly standup notes is chronologically faithful and functionally useless, because nobody ever asks a dated question. The questions that arrive are about subjects: this system, this field, this decision, this failure mode.
The second failure is capturing everything. An analyst who transcribes meetings into a wiki produces volume without retrievability, and volume without retrievability is a graveyard. The fix is a hard rule: a note exists to answer a future question. If you cannot name the question, do not write the note.
The third failure is tooling churn. People spend a weekend configuring a graph view, plugins, and a tagging taxonomy, then abandon the system when they change employers and lose the tool. Which leads directly to the format decision.
One scoping note before that: this article is about the method, the note types and the organizing principle, and it holds whichever editor you use. If you want the tool-level build with folder structure, atomic notes per ISO 20022 message, and daily investigation logs, that is Obsidian as an analyst’s second brain.
Why plain Markdown in git, not Confluence or Notion?
Use plain Markdown files in a git repository for your personal layer, and keep the corporate wiki for team-owned documents. Four concrete reasons:
It diffs. git log on a system note shows how your understanding of that system changed over two years. That history is genuinely valuable: it shows you what you believed before the incident that corrected you.
It is portable. Your second brain should outlive your employer’s tooling decisions and your own job changes. Plain text files survive everything. Keep anything confidential out of it, keep it in a private repository, and it moves with you.
It is greppable. Full-text search across hundreds of notes with ordinary tools is faster than any web interface. Two seconds to find every note mentioning pacs.002 beats clicking through a wiki hierarchy. If your command-line search skills are thin, regex for analysts and git for analysts are the two prerequisites worth an afternoon each.
It is the best input format for AI. This matters more every month. When you attach grounding documents to a prompt, Markdown is clean, structured, and token-efficient. Exported wiki HTML is noise. Your second brain is not just for you; it is the corpus you hand a model so it stops inventing field names, which is exactly the dependency described in prompt patterns for requirements work.
One warning on confidentiality. Client-specific rules, credentials, real customer data, and internal architecture that your employment agreement covers do not belong in a personal repository. What you keep is the generalizable version: the pattern, the reasoning, the lesson. “Repair queue re-validation was chosen because partial re-validation cannot prove the message is still compliant” is a portable insight. The client’s actual routing table is not yours to take.
What are the four note types?
Almost all the value comes from four types. If a note is not one of these, it is an unfiled draft.
System notes
One note per system, service, or interface you work with. This is your model of the thing, and it is the note you reread before every workshop about it.
# Payment Orchestrator
## What it does
Receives inbound customer payment instructions, screens them,
routes to the correct rail, publishes status events.
## Interfaces
- In: POST /v2/payments (OpenAPI at <internal link>)
- In: pain.001 file drop, SFTP, batch cut 15:30 local
- Out: payments.status.v3 Kafka topic
- Out: pacs.008 to the clearing gateway
## States
RECEIVED > SCREENED > ROUTED > SETTLED
> REJECTED (terminal)
> REPAIR (manual, re-enters at SCREENED)
## Quirks that have bitten me
- Status events are at-least-once. Consumers must be idempotent.
- REPAIR re-validates the whole message, not the edited field. See DR-014.
- The 15:30 cut is local time, not UTC. Daylight saving has caused
two incidents. See INC-2026-03.
The quirks section is the most valuable part of the whole second brain. Those are the facts that exist in no specification, that you learned by breaking something, and that new joiners spend months rediscovering. Related to this: a shared, formal version of the field-level layer belongs in a team artifact, which is what the data dictionary is for, and the templates for the team-facing versions of all of these are in Real-World BA Deliverables.
Decision records
One note per decision, numbered, immutable once written. Borrowed from the architecture decision record practice and shortened for analyst use:
# DR-014: Repair queue re-validates the full message
Date: 2026-02-11
Status: Accepted
Deciders: payments product owner, compliance lead, tech lead
## Context
Operators edit rejected messages in the repair queue. Editing one
field could leave the message non-compliant in a way we cannot
detect without a full validation pass.
## Options
1. Re-validate only the edited field. Fast, cheap, unsafe.
2. Re-validate the full message. Slower, proves compliance.
3. Block editing, require full resubmission from the originator.
Safest, unacceptable operationally.
## Decision
Option 2.
## Consequences
- Repair throughput limited to roughly 40 messages per minute.
- Any new validation rule applies retroactively to repaired items.
- Operators see a 2 to 4 second delay per save. Accepted.
Ten minutes to write. It has since answered that question for four different people, including a regulator’s consultant.
Incident notes
One note per production incident that taught you something, whether or not you owned the postmortem. The structure is the timeline, the root cause, and, most importantly, what it revealed about the system that the documentation did not say. The daylight saving incident above added a line to a system note and prevented a repeat. I wrote about what this looks like in practice in what I learned reading logs during a major incident.
Field notes
Short, ugly, same-day captures. A quirk a developer mentioned in passing, a status value you saw in production that is not in the spec, a name you should remember. Field notes have one rule: they get filed into a system note, a decision record, or an incident note within a week, or they get deleted. An unfiled capture pile is the graveyard again.
How do you actually work the system daily?
The workflow is three habits, and they take about fifteen minutes a day total.
Capture, in one place. One inbox file. Anything interesting goes in with a timestamp and no formatting effort. Do not decide where it belongs while a meeting is happening.
File weekly. Once a week, empty the inbox into the four note types. This is the step people skip, and skipping it is what kills the system. It takes ten minutes when you do it weekly and two hours when you do it monthly, which is why it then never happens again.
Answer from notes, not memory. The habit that makes it real: when someone asks you a question, look it up in your notes even when you think you remember. You will discover the gaps immediately, and each gap you fill makes the next answer faster. Within a few months your default answer to “why is it like this” becomes a link, and the reputational effect of that is substantial. Being the analyst who can produce the reasoning behind a two-year-old rule in ten seconds changes how a team treats you, which is a career point I make at length in The Technical Skills Guide for BAs.
How does the second brain feed AI assistance?
This is the compounding part, and it is why the note format matters. Language models produce correct analyst artifacts only when grounded in real documents, and your second brain is a curated set of real documents that is current, in your organization’s vocabulary, and already structured.
Three concrete uses I run weekly:
- Grounded drafting. Attach the system note and the relevant decision records, then ask for a first-draft impact assessment for a proposed change. The output uses my actual states and field names because they were in the context, not invented.
- Gap interrogation. Attach a system note and ask what a new joiner would still not understand about this system. The list is uncomfortably good, and it drives the next round of note writing.
- Cross-note synthesis. Attach five incident notes and ask for the recurring failure pattern. On one programme this surfaced that three of six incidents in a year traced to timezone handling, which became a piece of technical debt that actually got funded because the pattern was visible.
The dependency runs one way: better notes, better AI output. There is no prompt that compensates for having nothing to attach. The prompt side of that pairing is what I collected in The Technical BA Prompt Toolkit, but the corpus has to be yours.
What does a good analyst second brain look like after a year?
Concretely: somewhere between 30 and 60 system notes covering every service you touch, 20 to 40 numbered decision records, 10 to 20 incident notes, and an empty inbox. Total size a few megabytes of text. Value: you are the person who knows why, and “why” is the knowledge that does not come out of a repository, a wiki, or a model.
That is the honest strategic point. Code is increasingly readable by anyone with an assistant. Specifications can be drafted in minutes. What remains scarce is the accumulated, organization-specific knowledge of how these systems really behave and which decisions are load-bearing. A second brain is how one analyst accumulates that faster than the organization loses it to turnover.
The takeaway
Build the second brain as four note types, organized by system and decision, in plain Markdown, in git. Capture in one inbox daily, file weekly, and answer questions from notes rather than memory. Keep the confidential specifics out and the generalizable reasoning in.
Start with one file today: a system note for the service you understand least, with a quirks section. Then write the decision record for the next decision you sit in on. If you want the team-facing artifact templates that pair with the personal layer, they are in Real-World BA Deliverables and The Complete Tech BA Bundle, or browse everything at The Tech BA Toolkit.
Ahmed is a Senior Technical Business Analyst with 10+ years in banking and payments. He builds practical guides and tools for analysts at The Tech BA Toolkit.
Tags: Business Analysis, Productivity, Knowledge Management, Documentation, Career Growth
About the author
Analyst Engineering is written by Ahmed, a Senior Technical Business Analyst with 10+ years of banking and payments delivery experience: ISO 20022 and SWIFT messaging, payments API integration, Kafka event validation, and production support. Every article comes from real delivery work, and each one is reviewed and updated as tools and standards change.
Related articles
- Obsidian as an Analyst's Second Brain: The Vault That Survives a Payments Programme How to build an Obsidian vault for analyst work: folder structure, atomic notes per ISO 20022 message and reason code, daily investigation logs, and Jira sync.
- The AI-Augmented Analyst Workflow: Five Flows That Actually Ship The five AI flows that measurably speed up analyst delivery: transcript to draft spec, negative test matrix, test data, log triage, and contract diffs.
- Prompt Patterns for Requirements Work: Six Patterns I Reuse Weekly Six reusable prompt patterns for requirements work: grounded extraction, format contract, adversarial review, gap interrogation, traceability, testability.
- Automating the Analyst Workflow: What to Script First Which analyst tasks to automate first, ranked by payback: environment checks, test data setup, reconciliation, contract validation, ticket evidence.
Newsletter
Subscribe
Practical, no-fluff playbooks for technical analysts who analyze, code, test, and support. New articles straight to your inbox.
No spam. Unsubscribe anytime.