Skip to content
View HHFinAi's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report HHFinAi

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
HHFinAi/README.md

HHFinAi — institutional sustainable finance AI research workflows.

HHFinAi — Institutional Sustainable Finance AI

Open research agents and analyst workflows connecting sustainability evidence to financial materiality, security valuation, portfolio decisions, impact and stewardship.

Institutional-quality buy-side research · Tradable decision support · Traceable evidence · Auditable workflows · Human judgment

Research philosophy: AI should expand research coverage without obscuring sources, assumptions, uncertainty, legal boundaries or analyst accountability. “Institutional-quality” describes process design and review controls—not independent certification, guaranteed compliance or investment performance.

Sustainable-finance research stack

flowchart TD
    E[Primary evidence and mandate] --> M[Financial materiality]
    E --> T[Transition credibility]
    E --> N[Nature and biodiversity]
    E --> H[Human rights and social value chain]
    E --> C[Carbon accounting and attribution]
    E --> B[Bond and credit diligence]
    E --> S[Sovereign and social-impact finance]

    M --> V[Valuation and investment case]
    T --> V
    N --> V
    H --> V
    B --> V
    S --> V

    C --> P[Portfolio and mandate review]
    V --> P
    P --> ST[Stewardship and controversy]
    P --> I[Impact and blended finance]
    ST --> IC[Investment committee / human review]
    I --> IC
Loading

Flagship agents

Security and issuer underwriting

Agent Investment question
Sustainability-to-Financial-Materiality Analysis Which sustainability issues change revenue, margins, cash flow, credit or valuation—and by how much?
Transition-Plan Credibility Assessment Are issuer targets supported by comparable boundaries, funded implementation and observable delivery?
Sustainable Bond Diligence Agent Does a labelled or transition bond combine acceptable underlying credit, credible sustainability claims and investable relative value?
Labelled-Bond and Sustainability-Linked-Bond Diligence What is the specific bond’s credit, contractual, KPI, label and relative-value case?
Climate Investment AI Agent How do physical and transition risks transmit into equity valuation and bond credit?

Portfolio, mandate and ownership

Agent Investment question
Portfolio Carbon Accounting and Attribution What emissions are financed, how complete is the inventory, and why did it change?
Sustainable-Investment Mandate Assessment Does evidence support the stated mandate under the versioned prospectus and applicable rulebook, and where is the result unknown?
Stewardship and Controversy Assessment What is evidenced, what change is sought, and what escalation or investment review is warranted?
Sustainable Investment Agent for SFDR Article 8 & 9 Funds How can sustainable-investment research, binding elements, stewardship, impact and disclosure be organized into repeatable workflows?

Nature, social impact and development finance

Agent Investment question
Nature and Biodiversity Investment Agent How do ecosystem dependencies, impacts and outcomes connect to financial underwriting without inventing a universal biodiversity score?
Human-Rights and Social-Value-Chain Diligence Who may be harmed, how severe is the risk, and what prevention, remedy and investment response is evidenced?
Impact and Blended-Finance Assessment What outcomes and financing are plausibly additional, who bears risk, and is the structure commercially and developmentally defensible?
Sovereign and Social-Impact Finance Agent How do sovereign repayment, contractual recourse, fiscal economics, additionality and social outcomes fit together?

What “institutional-quality” means here

The repositories are designed around inspectable research-process controls:

  • Evidence lineage: source IDs, dates, document locations and entity/instrument boundaries.
  • Financial transmission: sustainability issues must connect to explicit cash-flow, credit, valuation or portfolio assumptions when an investment conclusion is made.
  • Reproducible calculations: deterministic helpers expose inputs, units and assumptions rather than hiding arithmetic in prose.
  • Missing-data discipline: unknown or unverified evidence remains unknown; material gaps can block approval.
  • Revision control: upstream changes can invalidate downstream analysis and prior review.
  • Independent challenge: counterarguments, thesis breakers and unresolved issues remain visible.
  • Human accountability: agents support research decisions; they do not self-approve investments or execute trades.

Tradable research, not sustainability commentary

The objective is to move from:

Sustainability disclosure
        ↓
Material issue
        ↓
Financial transmission
        ↓
Security / portfolio implication
        ↓
Valuation, relative value or risk
        ↓
Catalyst / monitoring trigger
        ↓
Human investment decision

A sustainability claim is not treated as a trade thesis by itself. Likewise, a credible label, target or impact narrative does not substitute for credit quality, valuation, liquidity or portfolio constraints.

Repository design

Across the agent suite, repositories generally include:

README.md          → answer-first overview
SKILL.md           → agent/skill entry point
AGENTS.md          → research-stage contracts
WORKFLOW.md        → orchestration and handoffs
sf_agent/          → executable workflow and calculations
schemas/           → structured input/output contracts
skills/            → bounded analytical capabilities
prompts/           → specialist research instructions
references/        → methodology and source controls
examples/          → synthetic worked examples
tests/             → regression and control tests
.github/workflows/ → GitHub CI validation

Core research domains

Investment analysis: Sustainable Finance · Climate Investing · Fixed Income · Credit Analysis · Fundamental Equity · Sovereign Debt · Impact Investing

Sustainability research: Transition Finance · Carbon Accounting · Nature & Biodiversity · Human Rights · Stewardship · SFDR / Sustainable Mandates · Blended Finance

Research infrastructure: Python · Agent Skills · Structured Evidence · Deterministic Calculations · Workflow Validation · Human Review

Other research infrastructure

My general investment-research work is available in:

Sector-specific healthcare and life-sciences research is maintained separately at hh-health-AI.

Use and limitations

These repositories are research and educational infrastructure. They are not investment advice, broker systems, autonomous trading agents, independent audit opinions or certifications of regulatory compliance. Most workflows require a human or external AI host to retrieve authorized evidence and perform substantive research. Inspect each repository’s methodology, validation scope and limitations before relying on its output.


Evidence → economics → valuation → portfolio decision → human judgment

Pinned Loading

  1. Sustainable-Investment-Agent-for-SFDR-Article-8-9-Funds Sustainable-Investment-Agent-for-SFDR-Article-8-9-Funds Public

    Institutional-grade AI prompts for buy-side Sustainable Investment analysts running SFDR Article 8 and Article 9 global public equity strategies.

    1

  2. claude-equity-research-skills claude-equity-research-skills Public

    Institutional-quality equity research skills for Claude AI — systematizing the fundamental analysis playbook from buy-side investing into reusable, AI-executable frameworks.

    Python 9

  3. earnings-analysis earnings-analysis Public

    quick earnings analysis with consensus Wall Street forecast, with past guidance, with peer industry trend.

    Python 2

  4. Institutional-Growth-Equity-Skills Institutional-Growth-Equity-Skills Public

    A curated bundle of 16 Claude skills for institutional-quality growth equity research

    Python 2

  5. climate-investment-ai-agent-in-equity-and-bond-markets climate-investment-ai-agent-in-equity-and-bond-markets Public

    Python 1

  6. Sector-equity-agent Sector-equity-agent Public

    Institutional healthcare buy side prompt library

    Python 1