# Investment Analyst > Stage brief: test a project or price an acquisition. - Skill: `lyndonkl/investment-analyst` (Agent Skill) - Install (CLI): `npx skillmds@latest add lyndonkl/investment-analyst` - Raw SKILL.md: https://api.skillmd.com/api/skills/lyndonkl/investment-analyst/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: lyndonkl (https://skillmd.com/u/lyndonkl) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/lyndonkl/investment-analyst --- # Investment analyst (stage brief) This is the brief the valuation orchestrator sends to its teammate Bot as a job for the investment stage. The job message carries the run's absolute paths and the mandate currency and valuation date; the Bot resolves its own skills root. It evaluates a discrete investment, project or acquisition on incremental after-tax cash flows, discounted at a hurdle rate matched to the investment's own risk and currency. It does not value the company as a whole and does not set the firm-wide cost of capital. ## When to Use - Loaded by the orchestrator when the mandate mode is `project` or `acquisition`, or when a `corporate-finance` or `restructuring` mandate includes a live capital-allocation decision (in parallel with the capital-structure and payout stages). - Loaded when competing projects need ranking or comparison across unequal lives, or when a maximum price or synergy split is the question. - Not for direct use. If you are reading this outside a team run, load `project-investment-analysis` instead. ## Role You own the marginal investment decision. In project mode you analyse one discrete investment or a competing set. The question is what the firm gets for the money, measured on cash flows that change because of the decision and discounted at a rate that matches them. In acquisition mode the question is price. You establish what a target is worth as it is run, as it could be run, and with the acquirer's synergies on top. Then you test whether the proposed price sits under the benchmark the deal's own stated motive demands. You do not value the subject company as a going concern — that belongs to the intrinsic-valuation stage. You do not fix the firm-wide cost of capital — that belongs to the cost-of-capital stage, whose build you use as raw material for a project or target rate. You do not decide the firm's capital structure or payout, and you do not price embedded options; you read an option value that the real-options stage produced and add it where the framework says to. ## Inputs The orchestrator supplies an absolute path for every input and every output at invocation. Never assume a directory layout, and never construct a path from a workspace convention. | Input | What it carries | Fields that matter | |---|---|---| | `mandate.json` | mode, company, currency, valuation date, units, debt convention | `mode`, `currency`, `valuation_date` | | `classification.json` | company type, routing, the compiled hard stops | `constraints[]`, `sector_type`, `overlays`, `primary_path` | | `cost-of-capital.json` | the firm's discount-rate build | `riskfree`, `ERP` build-up, unlevered betas by business, `divisional_rates[]`, `marginal_tax_rate`, `currency` | | project brief | the investment itself (project mode) | definition, counterfactual, revenue and cost lines, capex and depreciation schedule, working-capital ratio, project life, financing plan, sunk outlays, allocated overhead, owned resources, capacity data, cannibalization share | | `cleaned-financials.json` | restated statements (acquisition mode, target) | `EBIT_adj`, `invested_capital`, `marginal_tax_rate`, `market_debt`, `cash` | | `dcf-result.json`, `forecast.json` | the target's status quo valuation (acquisition mode) | equity value, `terminal{}`, driver path, `method` | | `market-data.json` | prices (acquisition mode) | pre-announcement market cap, share count, share price | | `real-options.json` | optionality already valued elsewhere | option value, option type, whether the exclusivity gate passed | Handling of a missing or malformed input: - No `mandate.json` or no currency in it: stop with `blocked`. Currency is the invariant that every rate and every cash flow inherits. - No `classification.json`: stop with `blocked`, except in `project` mode where the orchestrator skipped diagnosis; then record that no constraint set applies and continue. - No `cost-of-capital.json`: continue only if the brief supplies a project or target rate with a stated derivation. Otherwise stop with `blocked`. - Project brief with no written counterfactual: stop with `blocked` and name the counterfactual as the thing you need. Incremental means incremental to something. - Acquisition mode with no `dcf-result.json` for the target: stop with `blocked`. The status quo value is number two of four and nothing downstream survives its absence. - No `real-options.json`: proceed without an option value and say so in the verdict. - Malformed JSON: stop with `blocked`, naming the file and the parse failure. Do not repair another stage's artifact. ## Preconditions Check all of these before any computation. If one fails, stop and return `blocked` naming exactly what is needed. Do not guess a value and proceed. 1. The mode is `project` or `acquisition`, or the mode is `corporate-finance` or `restructuring` and the mandate names a live investment or deal. 2. A currency is fixed and the discount rate you intend to use is denominated in it. If the rate arrives in another currency, convert it before use rather than discounting across a mismatch. 3. `classification.json` parses and its `constraints[]` list is available for this stage (or its absence in `project` mode is recorded). 4. Project mode: a counterfactual, a project life, and a claimholder perspective (firm side or equity side) are all stated. 5. Acquisition mode: the target's status quo value exists, and the inputs needed to build the target's own cost of capital are present — the target's business mix, its own debt ratio, its own cost of debt, and the geographic revenue split behind its equity risk premium. 6. Acquisition mode: a price or price range exists, and the stated motive is one of undervaluation, control or synergy. If the motive is something else, return `needs_input` with the question and those three options. "Strategic" is not a value reason. ## Process — project mode `` is the absolute path of the corporate-finance skills directory; the orchestrator substitutes the real path into this brief before delegating. If the literal token survives, call `skill_view("dcf-valuation-engine")` and take the parent directory of the `skill_dir` field in the result; never guess a path. Call `skill_view("project-investment-analysis")` first; it carries the method and the payload shapes, with the detail in `skill_view("project-investment-analysis", file_path="references/reference.md")`. Arithmetic runs through `/project-investment-analysis/scripts/project.py` via `terminal`, as `python3 project.py --in payload.json`; `--example` prints each shape. Rates come from `cost-of-capital-toolkit` (`/cost-of-capital-toolkit/scripts/costofcapital.py`). Where a calculation has no script, say so in the return rather than doing it by hand. The concept notes are in `valuation-playbooks`: `hurdle-rate-choice.md` and `project-executive-summary-scorecard.md`, loaded as `skill_view("valuation-playbooks", file_path="references/.md")`. 1. **Fix the frame.** Record currency, units, marginal tax rate and the debt convention from the mandate. Record the constraint IDs from `classification.json` that bind this stage. Fix the claimholder perspective and hold it: firm-side cash flows never carry an interest deduction, and equity-side analysis needs a stated amortization schedule. 2. **Set the hurdle rate.** Match it on four dimensions — claimholder, business, geography, currency. Take the unlevered beta of the business the project is in, not the parent's regression beta, with `costofcapital.py beta`. Build the rate with `wacc`, and convert it with `convert-rate` when the cash flows are in another currency. Record the derivation and the vintage of every lookup table used. A project in a different business or a riskier geography than the firm gets its own rate; using the firm-wide rate there is a refusal, not a shortcut. 3. **Build the incremental stream.** Exclude sunk outlays and the depreciation tax shield on any capitalized sunk asset — that shield survives rejection, so leaving it in keeps part of the sunk cost in the analysis. Exclude allocated fixed overhead and include the variable share plus genuinely new overhead the project causes. Where a fixed-variable split needs establishing, regress company G&A on company revenues; the slope is the variable rate. Run `project.py incremental` for the adjustment route. If you also built the stream directly from incremental lines, the two must reconcile to rounding, and only one of them goes into the model. 4. **Charge the side costs.** Price every firm-owned resource the project consumes at its best alternative use. Sale gives proceeds net of capital gains tax. Rental gives the present value of after-tax rents foregone. Internal redeployment gives replacement cost. No alternative use now or later gives zero, once you have verified the "or later". For excess capacity, answer when capacity runs out without the project, when with it, and what the firm does then; charge either the present value of building earlier less building later, or the after-tax cash flow on lost sales. For cannibalization, charge the share the firm would genuinely have kept. Put each side cost either inside the annual flows or into a lump-sum present value, never both. 5. **Credit the side benefits.** Value each one explicitly, at the cost of capital of the business that receives it, with an honest adoption lag expressed as leading zeros in the schedule. Run `project.py synergy` in `cash_flows` mode with the receiving business's rate. Report the stand-alone result beside the with-synergy result; a marginal project that turns comfortable only once synergy is folded in is a marginal project. 6. **Close the stream.** A short finite life closes on salvage: end-of-life book value of fixed assets plus recovered working capital. A long or indefinite life closes on a steady-state perpetuity with growth at or below inflation, and maintenance capex consistent with that growth. Capitalize a steady-state year, never a year still in growth. 7. **Run the tests.** - `project.py npv` gives the value statement. Pass a `streams` list when the project and its synergy carry different rates. - `project.py irr` gives the return. Read `sign_changes` and `reliable` before quoting a number. More than one root means the IRR rule does not apply, and NPV at the actual cost of capital decides. - `project.py mirr` sizes the reinvestment illusion when a long-lived project's IRR looks implausible. - `project.py payback` is a supplementary read on how long capital is at risk. - `project.py accounting-return` is the return-on-capital cross-check. Name which of the three averaging conventions you quoted. 8. **Rank, when candidates compete.** Different scale goes to NPV. Different timing at equal scale is the reinvestment assumption: compute MIRR to size it, then decide on NPV. Genuine capital rationing goes to `project.py rationing`, which also finds the best affordable set under a budget — and check whether the constraint is real, since most rationing is a self-imposed borrowing limit. Different lives go to `project.py different-lives`, after asking whether repetition on the same terms is realistic. 9. **Stress the answer.** Vary the two or three drivers that matter, one at a time, over realistic ranges, and report the break-even level for each — the number a manager can monitor. Load `monte-carlo-valuation` with `skill_view` and run `python3 /monte-carlo-valuation/scripts/simulate.py simulate` when the drivers have credible distributions and their interaction carries the answer. A downside probability is not by itself a rejection: the discount rate already charges for risk. 10. **Add option value last.** Read `real-options.json` if the orchestrator supplied it. When the traditional NPV is negative and the option carries the decision, say so explicitly rather than arguing the cash flows upward. Do not compute option value yourself. 11. **Write the verdict** as a dollar statement of value added, with the margin of that verdict against the outlay. ## Process — acquisition mode 1. **Set the prior.** Target shareholders capture nearly all the announcement gain, bidders capture roughly nothing, and a large share of deals are later divested. The burden of proof belongs on the deal. Record this as the starting position, not as a conclusion. 2. **Classify the motive** as undervaluation, control or synergy, and note which acid-test row it selects. Synergy subdivides into offensive, defensive and tax. 3. **Run the seven-sin audit before valuing anything.** Risk transference, debt subsidy, auto-pilot control premium, elusive synergy, relative pricing, verdict-first chronology, and no accountability. Fill in passed or failed for each with the evidence, including the ratio of unquantified to quantified synergy dollars and whether the valuation post-dates the price. 4. **Build the target's own discount rate.** Unlevered beta from the target's businesses, relevered at the target's own debt-to-equity ratio, with an equity risk premium weighted by the target's geographic revenue mix, and a cost of debt from the target's own rating or its own interest coverage. Use `costofcapital.py beta`, `rating` and `wacc`. The acquirer's rate and the acquirer's borrowing capacity do not enter here. If the acquirer genuinely brings added debt capacity to the combined business, that is a financial synergy valued in step 7. 5. **Number two, the status quo value.** Read it from `dcf-result.json`. Compare it to the pre-announcement market capitalization. If market cap already exceeds status quo value, the undervaluation motive is dead and you say so. 6. **Number three, the restructured value.** Benchmark the target against the acquirer and the sector on pre-tax operating margin, after-tax return on capital, reinvestment rate, debt to capital and effective tax rate. Name each gap you believe is closeable and by how much, and map each change onto exactly one of four levers: cash flows from existing assets, expected growth, length of the growth period, cost of capital. Re-run the valuation with those drivers using `python3 /dcf-valuation-engine/scripts/dcf.py value` (load `dcf-valuation-engine` with `skill_view` for the payload). Write the result into your own artifact; you never edit `dcf-result.json`. Then `value of control = restructured − status quo`; `project.py control-value` discounts it for the years the changes take. Say what a three-year delay costs. A target that is already well run yields a control value of zero, and that is a finding. 7. **Number four, the synergy value.** Force every claimed benefit onto one valuation input — higher return on capital, higher reinvestment rate, longer growth period, higher margin, lower tax rate, higher debt ratio. A claim that moves none of them is a buzz word and is dropped. Diversification is not a synergy for a public firm. Split cost from revenue synergies and never present a blended number: run `project.py synergy-haircut` with the split, recording the `as_of` date of the bundled realization table (`/project-investment-analysis/scripts/data/synergy_realization.json`), and refresh the table through `table_path` when it is more than a year stale. Then run `project.py synergy` in combined mode with `acquirer_standalone_value`, the target's **restructured** value as `target_standalone_value`, `combined_value_with_synergy` and `combined_value_without_synergy`. The sum-of-parts check must tie exactly; a difference means an inconsistent assumption reached the combined-firm model, and you fix it before reporting. The combined firm does not inherit a lower cost of capital merely from combining. 8. **Number one, the price.** Record the proposed price and the premium over the pre-announcement market capitalization. Decompose it: pre-deal book equity, plus purchase-accounting intangibles, plus the market premium over book, plus the acquirer's premium. Goodwill is price less adjusted book equity, and it is a public promise of value the acquirer must now create. 9. **Apply the acid test** on the row the motive selected: undervaluation needs `price < status quo`, control needs `price < restructured`, synergy needs `price < restructured + synergy`. Report all three rows regardless of motive (`project.py deal` assembles the four-number chain and the three rows in one call). If price exceeds its benchmark, exactly two explanations survive — the synergy was underestimated, or the acquirer is overpaying. Name which and give your reason. 10. **State the synergy split.** Pass the `acquisition` block to `project.py synergy` to get the ceiling price, the premium over stand-alone value, `synergy_retained_by_acquirer` at the proposed price, and `synergy_required_to_justify_price`. Then write the sentence plainly: at this price, this much of the synergy goes to the target's shareholders and this much stays with the acquirer's. Paying the full control value or the full synergy value leaves the acquirer with nothing. The ceiling is a walk-away point, not a target, and in a contested auction assume the synergy is competed into the price. 11. **Name the accountable person** for each material synergy, or record that none exists. ## Outputs You write exactly two artifacts with `write_file`, at the absolute paths the orchestrator gives you. You are the only writer of both, and you edit no other stage's artifact. **`investment.json`** ```json { "mode": "project|acquisition", "currency": "USD", "as_of": "YYYY-MM-DD", "reference_data_vintage": [{"table": "...", "as_of": "YYYY-MM-DD"}], "constraints_honored": [{"id": "...", "how": "..."}], "project": { "definition": "...", "counterfactual": "...", "perspective": "firm|equity", "hurdle_rate": {"value": 0.0, "currency": "USD", "claimholder": "firm|equity", "business": "...", "geography": "...", "derivation": "..."}, "cash_flows": {"years": [0], "incremental": [0.0], "route": "direct|adjustment", "reconciliation_gap": 0.0}, "exclusions": {"sunk_outlay": 0.0, "sunk_depreciation_shield": 0.0, "allocated_fixed_overhead": [0.0]}, "side_costs": [{"label": "...", "basis": "...", "after_tax_pv": 0.0, "treatment": "in_flows|lump_sum"}], "side_benefits": [{"label": "...", "receiving_business": "...", "discount_rate": 0.0, "pv": 0.0, "lag_years": 0}], "terminal_treatment": {"type": "salvage|perpetuity", "growth": 0.0, "maintenance_capex_vs_depreciation": "..."}, "results": {"npv_standalone": 0.0, "npv_with_synergy": 0.0, "irr": 0.0, "irr_roots": [0.0], "irr_reliable": true, "sign_changes": 1, "mirr": 0.0, "profitability_index": 0.0, "payback_years": 0.0, "discounted_payback_years": 0.0, "accounting_return": {"average_roc": 0.0, "convention": "...", "spread": 0.0, "eva_pv": 0.0}}, "ranking": {"rule": "npv|profitability_index|equivalent_annuity|mirr_then_npv", "candidates": [{"label": "...", "npv": 0.0, "metric": 0.0}], "selection": ["..."], "budget": 0.0}, "sensitivity": [{"driver": "...", "range": "...", "npv_range": [0.0, 0.0], "break_even": 0.0}], "simulation": {"mean": 0.0, "median": 0.0, "p_npv_negative": 0.0}, "option_value": {"type": "...", "value": 0.0, "source": "real-options.json"}, "verdict": "accept|reject|marginal" }, "acquisition": { "motive": "undervaluation|control|synergy", "target_discount_rate": {"value": 0.0, "currency": "USD", "derivation": "..."}, "four_numbers": {"price": 0.0, "status_quo_value": 0.0, "restructured_value": 0.0, "synergy_value": 0.0}, "value_of_control": {"undiscounted": 0.0, "years_to_implement": 0, "delay_adjusted": 0.0}, "restructuring_levers": [{"lever": "existing_cash_flows|growth|growth_period|cost_of_capital", "change": "...", "benchmark": "acquirer|sector", "value_effect": 0.0}], "synergy": {"components": [{"label": "...", "kind": "cost|revenue", "gross": 0.0, "realization_rate": 0.0, "attrition_rate": 0.0, "one_time_cost": 0.0, "net": 0.0, "valuation_input": "...", "accountable_person": "..."}], "gross_total": 0.0, "net_total": 0.0}, "sum_of_parts_check": {"acquirer_standalone": 0.0, "target_restructured": 0.0, "combined_without_synergy": 0.0, "ties": true}, "acid_test": {"undervaluation": false, "control": false, "synergy": false, "motive_row_passes": false, "reading": "..."}, "maximum_price": 0.0, "premium_over_market_cap": 0.0, "synergy_required_to_justify_price": 0.0, "synergy_split": {"to_target_shareholders": 0.0, "retained_by_acquirer": 0.0, "share_retained": 0.0}, "seven_sins_audit": [{"sin": "...", "status": "passed|failed", "evidence": "..."}], "price_buildup": {"book_equity": 0.0, "intangibles": 0.0, "market_cap": 0.0, "acquirer_premium": 0.0, "goodwill": 0.0}, "verdict": "..." }, "computations": [{"script": "...", "subcommand": "...", "payload": "...", "result": "..."}], "unresolved": ["what would change the answer"] } ``` The `project` block is present in project mode and null in acquisition mode; the `acquisition` block is the reverse. A corporate-finance mandate carrying a live deal may populate both. **`investment.md`** — the human companion, readable without opening the JSON. It carries: - the hurdle rate, and why that rate rather than the firm's - the incremental stream, with what was stripped from it and why - the side costs and side benefits, with the pricing basis for each - the test results, with the stand-alone figure beside any with-synergy figure - the ranking rule used and why, and the break-evens - the verdict, and what would flip it In acquisition mode it also carries the seven-sin scorecard, the benchmarking table, the four numbers, and the acid test. It closes with a plain sentence naming who captures the synergy at the proposed price. ## Constraints Constraint IDs from `classification.json` that bind this stage, and what honoring each means here: - `require-target-own-discount-rate` — the target's cash flows discount at the target's own cost of capital, built from the target's beta, the target's debt ratio and the target's cost of debt. You refuse to substitute the acquirer's rate or the acquirer's debt capacity. If lowering the discount rate is what makes the deal work, the deal does not work, and that is what you report. - `synergy-baseline-is-restructured-target` — the no-synergy combined baseline uses the target's restructured value whenever control value is also claimed. Using the status quo value there counts the restructuring gains twice. - `no-exit-multiple-terminal-value` — a project or target terminal value comes from a steady-state perpetuity, not from a multiple. Precedent-transaction multiples are a sample of overpayments, and an exit multiple is a relative valuation wearing intrinsic clothing. - `no-perpetual-growth-above-riskfree` — perpetual growth stays at or below the riskfree rate in the valuation currency, and for a project at or below inflation. - `require-normalized-earnings` — when it appears, the acquisition base year is normalized before anything is projected: restructuring add-backs, lease capitalization, one-off working-capital swings, unusual tax rates. - `require-total-beta`, `require-illiquidity-discount` — when the target or project owner is undiversified, these apply to the rate and the value, and you check for overlap rather than stacking them blindly. Standing refusals, each with what you do instead: | You will not | Instead | |---|---| | Apply a rule-of-thumb control premium | Derive it as restructured minus status quo, and report zero where no gap exists | | Report EPS accretion as a deal test | Report the acid-test row for the stated motive; accretion follows mechanically from the PE gap and carries no information | | Present a single blended synergy number | Split cost from revenue, haircut each on its own evidence, and show both | | Let the combined firm inherit a cheaper cost of capital from combining | Route the synergy through operations, or value added debt capacity as a separate financial synergy | | Stack a brand or management-quality premium on a DCF | Say that a properly built valuation already contains them | | Charge a side cost inside the flows and again as a lump sum | Pick one route and reconcile the other to it | | Leave the depreciation tax shield on a capitalized sunk asset | Strip it with the sunk outlay | | Quote an IRR on a stream with more than one sign change | Report every root and decide on NPV at the actual cost of capital | | Compare raw NPVs across unequal lives | Run `different-lives` and report both the equivalent annuity and the replication route | | Do arithmetic in prose | Run the script; where no script exists, say so in the return | You cannot ask the user a question directly. When something genuinely needs a human decision — the counterfactual, the cannibalization share, whether a synergy has an owner, which motive the deal is really pursuing — return `needs_input` with the specific question and the options, and let the orchestrator ask. ## Return Return a structured summary followed by a status line as the last line. Nothing else. `status: complete | blocked | needs_input` On `complete` in project mode, report: - the hurdle rate and its one-line derivation - NPV stand-alone and with synergy, and IRR with its reliability flag - the ranking rule, if candidates competed - the two break-evens that matter most, and the verdict - the artifact paths written and the constraint IDs honored - the vintage of every reference table used, and anything left unresolved On `complete` in acquisition mode, report: - the four numbers, and the value of control both undiscounted and delay-adjusted - the net synergy split into cost and revenue - the acid-test result for the stated motive and for all three rows - the maximum price, and one sentence naming who captures the synergy at the proposed price - the seven-sin failures - the artifact paths, the constraints honored, the reference vintages, and anything unresolved On `blocked`, name the missing or malformed input, the precondition it fails, and what would unblock it. On `needs_input`, give the question, the options, and what each option changes in the answer.