> ## Documentation Index
> Fetch the complete documentation index at: https://docs.investsync.co.nz/llms.txt
> Use this file to discover all available pages before exploring further.
# Planning
> Set portfolio goals, track progress, research opportunities, and keep Planning Workspace discussions together
## Overview
Planning helps your team turn portfolio ideas into clear actions. Use it to set investment goals, track progress against measurable targets, keep a watchlist of companies you are considering, and record planning conversations in one place.
## Before you start
Agree the planning outcome you want to track, who owns it, and what measure will show progress. This makes goals easier to review later.
## Basic and advanced use
* **Basic use**: create goals, track progress, and keep a focused watchlist.
* **Advanced use**: combine risk tolerance, portfolio-linked metrics, progress updates, market context, and Planning Workspace discussions for recurring reviews.
## Planning dashboard
Open **Planning** to see a compact working view of your plan and the market context around it. Stock search sits at the top, so you can move directly to a listed company, ETF, or fund while preparing for a review.
The **Planning workstreams** row takes you directly to:
* **Goals** for measurable portfolio outcomes and progress.
* **Allocation targets** for the portfolio mix you are working towards.
* **Planning Workspace** for research, decisions, and review conversations.
* **Tasks** for actions and follow-ups.
* **Benchmarks** for shared market and return comparisons.
The row also shows the current number of active and completed goals, open tasks, and watched investments. These counts are presented together so you can assess the planning workload without opening separate summary tiles.
Below the workstreams, use the market tables to compare movers by price, daily change, market value, and trading volume. Your watchlist shows current price movement alongside each investment, while the news table keeps the publisher, headline, and publication time aligned for quick scanning. Treat market information as research context, not as an instruction to buy or sell.
Use the Planning page at the start of a review meeting to confirm the intended direction, identify outstanding work, and then discuss relevant market developments.
## Tasks and follow-ups
Open **Planning > Tasks** to see actions raised by your team or created from other InvestSync work, including Planning Workspace discussions and portfolio reconciliation.
Tasks can also come from the onboarding data review. If an investment belongs
in the workspace but important supporting information is missing, select the
gap and choose **Create data list**. Each item becomes an open task that remains
here after onboarding, and the affected investment is marked **Follow up**.
Creating a data-list task does not import the affected investment or resolve the
missing information. Use the task to collect and review the supporting
document, then import the investment when its data is complete. Mark the task
done only after that follow-up work has been completed.
The summary at the top separates open, completed, and dismissed tasks. Use the matching tabs to focus the list, then:
* Select **Mark done** when the action is complete.
* Select **Dismiss** when the action is no longer needed.
* Select **Reopen** when a completed or dismissed task needs further work.
* Select **New task** to record a new action, owner, due date, or reminder.
Overdue tasks are clearly marked. Review open tasks during regular portfolio meetings so decisions continue through to completion.
## Benchmarks
Benchmarks are shared targets your organisation uses when reviewing portfolio
value growth. They can appear on the Dashboard and in Benchmarking Analytics
reports.
Open **Planning > Benchmarks** to add or update the list. Owners and admins can
save:
* S\&P 500.
* A listed stock.
* CPI plus a margin, such as CPI + 2%.
* A fixed annual target, such as 7%.
CPI benchmarks use the organisation country by default, and you can choose
another country when needed. Mark a benchmark as shown on the dashboard when it
should appear in the dashboard benchmark card.
## Investment goals
Goals are best for outcomes such as increasing portfolio value, improving income, reducing concentration, or preparing for a liquidity event.
### Create a goal
1. Open **Planning > Goals**.
2. Select **Create investment goal**.
3. Add a clear goal name, owner, target date, and summary.
4. Choose the first metric you want to track.
5. Enter the current value, target value, and measurement period.
6. Save the goal.
Good goal names are specific, for example "Grow portfolio market value to \$1m" or "Reduce exposure to a single sector below 20%".
### Set risk tolerance
The goals page includes an organisation-wide risk tolerance. Choose the option that best describes the shared investment posture:
* **Conservative**: focus on capital preservation and steady returns.
* **Balanced**: blend growth with stability.
* **Growth**: accept higher volatility for longer-term gains.
Review this before adding major goals, so targets match the team's appetite for risk.
### Track metrics
Each goal can have a primary metric and supporting metrics. Metrics can be:
* **Manual**: you enter progress yourself.
* **Portfolio**: the value follows available portfolio measures.
Use manual metrics for judgement-based targets, such as "review completed" or "allocation reduced". Use portfolio metrics for figures that should stay aligned with your holdings.
### Record progress
On a goal card, you can:
* Select **Record progress** to update a manual metric.
* Select **Add supporting metric** when one measure is not enough.
* Select **Add update** to record what changed, current status, confidence, and the date.
* Move goals between active, completed, and archived views.
Progress notes are useful for explaining why a goal is on track, at risk, or off track.
## Allocation targets
Allocation targets are saved plans that describe the portfolio mix you want to work towards. Plans are stored with full version history, so they survive across devices and sessions, and drift against the live portfolio is always visible.
Use this page when you are preparing a review, testing a future scenario, or discussing a change in risk profile.
When opening an allocation plan, you may briefly see placeholders while the current portfolio, discussion, and approval details load.
### Plans and scenarios
The workspace supports multiple plans side by side:
* **Active plan** — the plan the organisation is currently working towards. Only one plan can be active at a time; use **Set active** to promote a plan.
* **Scenarios** — draft plans used to compare options, such as a conservative plan against a growth-focused plan. Use **Duplicate as scenario** to branch from an existing plan.
Switch between plans with the chips above the workspace, or select **New plan** to start a fresh draft seeded from your current allocation.
### Set targets
1. Open **Planning > Allocation targets**.
2. Give the plan a name, risk profile, and objectives.
3. Set each category's target percentage with the slider or input.
4. Add a short rationale where a target needs context.
5. Add optional subcategory budgets where a category needs more detail.
6. Select **Save plan** (or **Save version** on an existing plan).
Targets should add to 100%. The **Target total** tile offers a **Balance** shortcut that scales every target proportionally when the total is off. Categories you hold but haven't planned appear as highlighted rows you can add with one click.
Subcategory budgets are optional. Use them when a category needs more detail, such as splitting income assets into short duration bonds, credit, and cash-like holdings. Budgets are measured against the total portfolio, and the editor warns when they exceed their category's target.
### Drift analysis
The workspace continuously compares the plan against your live portfolio:
* **Portfolio drift** — how far the whole portfolio sits from target (half the sum of absolute category drifts).
* **Drift from target** — per-category bars showing overweight and underweight positions, with the approximate trade needed to close each gap.
* **Current vs target** — a two-ring chart with today's portfolio inside and the plan outside.
### Version history
Every save records a numbered version with who saved it, whether it was AI-assisted, and an optional change note. Open **Version history** from the plan actions menu to review or restore an earlier version — restoring copies the old targets forward as a new version, so nothing is overwritten.
### Work with AI
The AI collaborator sits on the right of the workspace. Describe your goals, time horizon, and risk appetite in plain language — or start from one of the built-in prompts — and the AI proposes a complete plan that lands directly in the editor, marked with AI badges and rationales.
The AI knows your current allocation, existing categories and subcategories, active planning goals, and the organisation's risk tolerance. It reuses your existing categories before proposing new ones, and flags any genuinely new sleeves it suggests.
Iterate conversationally: ask it to trim a category, fund an increase from somewhere specific, or make the plan more defensive. Each proposal replaces the draft targets (with an **Undo** available in the toast), and nothing is stored until you save a version.
Review AI proposals before saving. Treat them as planning support, not a final recommendation.
By default the AI only works with your existing categories and subcategories. Use the **AI may suggest** toggles in the chat panel to let it propose new ones — anything new is only created in InvestSync when you save the plan, and the save dialog lists exactly what will be created first. Proposals are always normalised to total exactly 100%; any corrections are shown beneath the proposal in the chat.
### Collaborate and approve
The **Discussion** tab next to the AI collaborator holds the plan's conversation. Post updates, @mention teammates (they're notified), and attach supporting documents. The discussion also appears in Planning → Planning Workspace, labelled with the plan's name.
Use **Request approval of the latest version** to ask the organisation to sign the plan off. Everyone is notified and any member can approve or reject — except the requester, who can't decide their own request. Approvals are recorded against the specific plan version with who decided and when.
Rejecting requires a short reason and closes the plan out: the plan is archived and its discussion locked, while the versions, conversation, and decision stay on record for audit.
## Watchlist and market context
The Planning page includes a watchlist for companies or tickers you are monitoring before taking action.
### Add to the watchlist
1. Open **Planning**.
2. Search by company name or ticker.
3. Select **Add** beside the result.
4. Use the star icon for high-priority items.
Select a watchlist item to view its planning stock page. Remove items once they are no longer relevant.
Starred watchlist items also appear on the main Dashboard so priority companies stay visible during reviews. If market data is temporarily unavailable, refresh the page later to see the latest prices.
When a current quote cannot be reached, Planning may show a recently saved price so the investment remains available for review. Saved prices are labelled **Last available**, together with the time of the quote. Daily movement is hidden and no green or red movement colour is shown, because that change may no longer describe the current trading day.
### Research a listed investment
Select a ticker from your watchlist, market movers, or search results to open its research page. The page brings the information needed for a planning discussion into one view:
The page frame appears immediately while the latest market and portfolio information loads, so you can see that the selected investment is opening without waiting on a blank screen.
* Use the stock search at the top to move directly to another listed investment.
* The latest available price, daily movement, market capitalisation, and trading ranges.
* Price history over one month, three months, six months, one year, or five years.
* The compact market snapshot shows earnings per share, dividend yield, beta, trading volume, and other key figures without opening another panel.
* Any matching investments already held by your organisation, including their combined market value and unrealised result in the organisation reporting currency.
* Available analyst price targets and rating counts.
* Recent headlines and reported insider activity.
If the research page is using a saved quote, it shows **Last available market data** and the quote time near the price. The saved price can still support a discussion, but Planning does not present its daily movement as current.
Select **Add to watchlist** when the investment should remain visible during future reviews. Select **Start note** to record questions, research, or a decision against that ticker.
Use **AI research** to explore portfolio fit, compare the investment with existing holdings, test a bull and bear case, or identify key risks. You can also ask for an opportunity screen in plain English, such as “high-dividend stocks” or “lower-volatility healthcare companies”.
Opportunity screens appear as a table showing the available price, daily movement, market capitalisation, P/E ratio, dividend yield, and beta. Tick up to four rows and select **Research selected** to compare those candidates or examine one company in more depth. AI output and screening results are research support rather than recommendations. Check important figures, company announcements, and source information before making an investment decision.
### Use market context
The dashboard also shows risers, fallers, and recent market news. Treat these as prompts for research, not as instructions to buy or sell. Record any decisions or questions in Planning Workspace so the team can see the reasoning later.
## Planning Workspace
Use Planning Workspace to keep discussions attached to investments, tickers, entities, custodians, custodian portfolios, documents, or broader themes. The workspace is useful for:
* Capturing meeting outcomes.
* Recording why a goal was changed.
* Keeping research comments beside the relevant investment.
* Discussing agreements, minutes, custodian records, or entity records after they have been filed in Documents.
* Creating a shared history for future reviews.
Use Documents as the main place to store final files. Use Planning Workspace for the discussion, decision trail, follow-up actions, and team context around those files.
The workspace list is ordered by latest activity, so recently updated conversations stay at the top. Add a clear thread title, such as "Board meeting notes" or "Custodian agreement review", so the record is easy to recognise later. Use search to find a thread by title, investment, ticker, entity, custodian, document name, teammate, or recent comment.
Use the tabs to move between active threads, private drafts, closed threads, and archived threads. Filter thread tabs further to focus on investments, corporate records, opportunities, planning topics, or followed threads. Select a thread to open its focused conversation page, where you can reply, review the history, manage reminders, and view related files.
The top of each thread shows the title, linked topic, when it was last updated, how many messages, reminders, and files it contains, and who has been involved. Use this summary to check whether you are in the right conversation before adding a reply or follow-up.
Planning Workspace follows your chosen light or dark appearance. The list, thread view, editor, files, reminders, and actions stay on consistent backgrounds so long conversations remain easy to scan.
Turn on **Private thread** when a Planning Workspace discussion is for your own working record. Private threads are only visible to you, do not appear in other teammates' workspace lists, and do not send mention alerts to other people. The person who created the thread can change this later from the Actions tab.
When writing an update or reply, use the editor toolbar to format text, add lists, quote decisions, and include links. You can paste Markdown meeting notes into the editor and InvestSync will format headings, lists, links, tables, and emphasis for you. You can also paste images directly into the editor or insert them with the image button. Pasted images appear straight away and save in the background. Select an image to resize it directly on the image before saving.
Use the message menu to edit or delete a message you wrote while the thread is open. Edited messages are marked **Edited**. Select that label or **View edit history** to review your own earlier wording. Team members with the **View message edit history** permission can also review earlier versions written by other people. If you delete a message that already has replies, InvestSync leaves a **\{user deleted this message}** placeholder so those replies remain in the right place; a message without replies is removed completely.
Select **Add reference** to link organisation news, transactions, saved AI chats, or documents to the update you are writing. When the thread is linked to an investment, matching items appear first; use search to look across the wider organisation. News results show when the item was received, its expected event date, and its action-by date when available. Transaction results show the transaction date, amount, units, unit price, fees, and currency so you can confirm the correct record. Selected references appear as preview cards in the editor and remain interactive beside the message after it is posted.
Attaching a saved AI chat to a shared thread gives the other thread viewers read-only access to that conversation automatically. Attaching it from a private thread does not add viewers; if the thread is later made shared, access is added then. Check the selected conversation before posting if it contains context that should remain restricted.
For longer records, open the full editor from the new thread window. Write the first update in the main workspace and use **Thread details** to choose the linked investment, entity, custodian, document, opportunity, or planning topic. You can begin writing before those details are complete; **Create thread** becomes available once the required details and first update are ready. On smaller screens, select **Thread details** in the top bar to open these options.
Choose a thread type first. The category choices then collapse into a compact summary and the required detail becomes the next step. For example, **Investment** requires you to choose an investment, **Opportunity** requires a ticker, and **Planning topic** requires a title. InvestSync does not choose a record on your behalf. Select **Change** if you need to choose a different thread type. The Thread details panel scrolls independently when more options are available than fit on screen.
The full editor saves meaningful drafts privately on your current device. Use **New draft** when you want to keep the current draft and start another, or open an earlier draft from **Private drafts**. Supporting files stay queued with the draft. **Discard** asks for confirmation before removing the current draft from the device.
Inside a thread, use the tabs to keep the discussion separate from the record history. The Thread tab shows the conversation with replies nested under the comment they respond to, while History shows when the thread was created, replies were added, and mention emails were sent. Use Closed and Archived to review or change whether the thread can receive new replies and whether it appears in normal thread lists.
Select **Ask AI** beside the thread controls to open the chat side panel when you need a quick view of where a conversation stands. You can continue referring to the conversation while you ask questions, then close the panel to return to the full thread. Choose one of the compact suggested-question pills, such as **Bring me up to speed**, or ask about confirmed decisions, recent changes, open questions, and work that still needs attention.
The AI can check the conversation against current organisation records, including portfolio values and allocation, transactions, goals, investment events, entities, custodians, benchmarks, and upcoming commitments. It can also check listed-market information, exchange rates, and recent public sources when external context is useful. Private organisation details are never added to a public web search. The AI uses the details held with attached news, transactions, and saved AI chats as part of the conversation context. For document references and uploaded files, it only sees the recorded file details and does not read the document contents.
The AI separates recorded decisions from proposals and questions, and uses task status to distinguish completed work from open actions. Check important details against the thread before acting, especially dates, owners, and financial decisions. The AI chat is a temporary working view and is not added to the Planning Workspace discussion. Select **Clear chat** to start a fresh set of questions; clearing the chat does not change or delete the discussion.
Use **Set reminder** when a note needs follow-up at a specific date and time. Choose the teammates who should receive the reminder. Reminder times use your current timezone when you set or adjust them. When a reminder becomes due, InvestSync sends recipients an in-app notification and email with a link back to the thread. You can adjust a reminder, append extra context, or delete it from the Reminders tab while the thread remains open. If your Microsoft calendar is connected, you can also add the reminder to your calendar or schedule a follow-up meeting after saving the reminder. Meeting invites can include organisation members, external email addresses, and an optional Microsoft Teams link.
Use the **Actions** tab to update the thread title or when a thread no longer needs active discussion. Closing a thread keeps it visible but stops new replies until it is reopened. Archiving removes it from normal thread lists while keeping the record available by direct link. Deleting a thread is permanent and is only available to authorised team members.
## Good habits
Write goals in plain financial terms, with a target and timeframe.
Choose the measure that best shows whether the goal is succeeding.
Add short progress notes after reviews, decisions, or material changes.
Star the most important opportunities and remove stale ideas.
Use Planning Workspace to explain the reasoning behind changes, not just the final decision.
Planning works best when goals, metrics, watchlists, and Planning Workspace discussions are reviewed together. This gives your team a clear view of what you intended, what changed, and what needs action next.