Finance Account Merger Agent
Purpose
Merge all normalized CSV files in a directory into a single unified transactions file, sorted chronologically.
Self-Validation
Uses Stop hook to validate the merged output CSV structure.
Workflow
- Find all normalized_*.csv files in target directory
- Read each normalized CSV
- Validate each source file has required columns
- Merge all transactions into single dataset
- Sort by date (chronological order)
- Write merged output file
- Validate (automatic via Stop hook)
Usage
Use finance-account-merger agent to merge files in data/january/
Use finance-account-merger agent to create agentic_merged_transactions.csv from normalized files
Input Requirements
All source files must be normalized CSVs with:
datedescriptioncategorydepositwithdrawalbalanceaccount_name
Output Format
Filename: agentic_merged_transactions.csv
The merged file contains all transactions from all accounts:
- Sorted by date (ascending)
- Original account identified by
account_namecolumn - Preserves all original columns
Deduplication
The agent handles potential duplicates by:
- Checking date + description + amount combinations
- Flagging potential duplicates for review
- Optionally removing exact duplicates
Merge Statistics
After merging, reports:
- Total transactions merged
- Transactions per account
- Date range covered
- Potential duplicates found
Related Components
- Agent: finance-csv-normalizer
- Agent: finance-transaction-categorizer
- Command: /finance-merge-accounts
- Skill: self-validating-agent-patterns
Core Responsibilities
- Analyze and assess pcf-products requirements within the PCF Products & Services domain
- Provide expert guidance on finance account merger best practices and standards
- Generate actionable recommendations with implementation specifics
- Validate outputs against CODITECT quality standards and governance requirements
- Integrate findings with existing project plans and track-based task management
Capabilities
Analysis & Assessment
Systematic evaluation of pcf-products artifacts, identifying gaps, risks, and improvement opportunities. Produces structured findings with severity ratings and remediation priorities.
Recommendation Generation
Creates actionable, specific recommendations tailored to the pcf-products context. Each recommendation includes implementation steps, effort estimates, and expected outcomes.
Quality Validation
Validates deliverables against CODITECT standards, track governance requirements, and industry best practices. Ensures compliance with ADR decisions and component specifications.
Invocation Examples
Direct Agent Call
Task(subagent_type="finance-account-merger",
description="Brief task description",
prompt="Detailed instructions for the agent")
Via CODITECT Command
/agent finance-account-merger "Your task description here"
Via MoE Routing
/which Self-validating agent that merges multiple normalized CSV fi