### Documentation
Get started
- [Surfaice documentation](/docs/ai)
- [What is Surfaice?](/docs/concepts/what-is-surfaice/ai)
- [Quickstart](/docs/quickstart/ai)
- [Start by role](/docs/guides/start-by-role/ai)
- [Sign in and SSO](/docs/guides/sign-in/ai)
Guides
- [Workspaces](/docs/guides/workspaces/ai)
- [Connectors](/docs/guides/connectors/ai)
- [Chat with Hugo](/docs/guides/chat-with-hugo/ai)
- [Skills](/docs/guides/skills/ai)
- [Working with Hugo](/docs/guides/working-with-hugo/ai)
- [Punch Walk Guide](/docs/guides/punch-walk/ai)
- [Lease abstraction](/docs/guides/lease-abstraction/ai)
Use cases
- [Use cases overview](/docs/use-cases/overview/ai)
- [Teams & personas](/docs/use-cases/by-team/ai)
- [Lease administration](/docs/use-cases/lease-administration/ai)
- [CAM reconciliation](/docs/use-cases/cam-reconciliation/ai)
- [Store development](/docs/use-cases/store-development/ai)
- [Construction & closeout](/docs/use-cases/construction-and-closeout/ai)
- [Portfolio & renewals](/docs/use-cases/portfolio-and-renewals/ai)
- [Operations & facilities](/docs/use-cases/operations/ai)
Skills library
- [Skills library](/docs/skills/ai)
- [Lease & portfolio skills](/docs/skills/lease-and-portfolio/ai)
- [Store development skills](/docs/skills/store-development/ai)
- [Estimating & bid skills](/docs/skills/estimating-and-bids/ai)
- [Reporting & briefing skills](/docs/skills/reporting/ai)
- [Apps & automations](/docs/skills/apps-and-automations/ai)
- [Workspace admin skills](/docs/skills/workspace-admin/ai)
Concepts & trust
- [Permissions](/docs/concepts/permissions/ai)
- [Data handling](/docs/concepts/data-handling/ai)
- [Agent limitations](/docs/concepts/hugo-limitations/ai)
- [Trust FAQ](/docs/concepts/trust-faq/ai)
- [Audit trail](/docs/concepts/audit-trail/ai)
Help
- [Release notes](/docs/release-notes/ai)
- [Security overview](/docs/security/ai)
- [Status](https://status.surfaice.pro)
- [Open app](https://agent.surfaice.pro)
Get started
- [Surfaice documentation](/docs/ai)
- [What is Surfaice?](/docs/concepts/what-is-surfaice/ai)
- [Quickstart](/docs/quickstart/ai)
- [Start by role](/docs/guides/start-by-role/ai)
- [Sign in and SSO](/docs/guides/sign-in/ai)
Guides
- [Workspaces](/docs/guides/workspaces/ai)
- [Connectors](/docs/guides/connectors/ai)
- [Chat with Hugo](/docs/guides/chat-with-hugo/ai)
- [Skills](/docs/guides/skills/ai)
- [Working with Hugo](/docs/guides/working-with-hugo/ai)
- [Punch Walk Guide](/docs/guides/punch-walk/ai)
- [Lease abstraction](/docs/guides/lease-abstraction/ai)
Use cases
- [Use cases overview](/docs/use-cases/overview/ai)
- [Teams & personas](/docs/use-cases/by-team/ai)
- [Lease administration](/docs/use-cases/lease-administration/ai)
- [CAM reconciliation](/docs/use-cases/cam-reconciliation/ai)
- [Store development](/docs/use-cases/store-development/ai)
- [Construction & closeout](/docs/use-cases/construction-and-closeout/ai)
- [Portfolio & renewals](/docs/use-cases/portfolio-and-renewals/ai)
- [Operations & facilities](/docs/use-cases/operations/ai)
Skills library
- [Skills library](/docs/skills/ai)
- [Lease & portfolio skills](/docs/skills/lease-and-portfolio/ai)
- [Store development skills](/docs/skills/store-development/ai)
- [Estimating & bid skills](/docs/skills/estimating-and-bids/ai)
- [Reporting & briefing skills](/docs/skills/reporting/ai)
- [Apps & automations](/docs/skills/apps-and-automations/ai)
- [Workspace admin skills](/docs/skills/workspace-admin/ai)
Concepts & trust
- [Permissions](/docs/concepts/permissions/ai)
- [Data handling](/docs/concepts/data-handling/ai)
- [Agent limitations](/docs/concepts/hugo-limitations/ai)
- [Trust FAQ](/docs/concepts/trust-faq/ai)
- [Audit trail](/docs/concepts/audit-trail/ai)
Help
- [Release notes](/docs/release-notes/ai)
- [Security overview](/docs/security/ai)
- [Status](https://status.surfaice.pro)
- [Open app](https://agent.surfaice.pro)
# Working with Hugo
How to get reliable answers, scope work clearly, and review outputs before you trust them.
Use this guide with [Agent limitations](/docs/concepts/hugo-limitations/ai) and your workspace admin's connector policy. Surfaice is designed for high-stakes retail real estate work, **treat Hugo's outputs as drafts** until you verify citations and save what you intend to keep.
Note
For compliance and security claims, the canonical source is [surfaice.pro/security](/security/ai). Product docs explain how Hugo behaves; the security page states what Surfaice commits to.
## Getting accurate answers
- **Be specific:** include store number, landlord, project name, city, or date range when you can.
- **Confirm workspace:** you must be in the correct customer workspace before asking about portfolio data.
- **Prefer citations:** answers that show where a fact came from are easier to verify than uncited summaries.
- **One store before many:** for portfolio or folder-wide questions, validate on a single store you know well, then expand scope.
## Scope and coverage
Large requests, full-folder lease scans, multi-store maps, field closeout workflows, can take **30 seconds to several minutes**. That is expected when Hugo reads many files or runs structured skills.
For portfolio work:
- Ask **how many** stores or files were included in the answer.
- Narrow by region, landlord, or folder when the corpus is large.
- Maps and **Preview** artifacts depend on the skill completing successfully; if Preview is empty, retry with a smaller scope or contact [support](/docs/support/ai).
## Connectors and permissions
Hugo can only read what **you** can read in connected systems. See [Connectors](/docs/guides/connectors/ai) and [Permissions](/docs/concepts/permissions/ai).
| Situation | What to check |
| --- | --- |
| Hugo cannot access Lucernex or SharePoint | Connector enabled for your role; you can open the same record outside Surfaice |
| Outlook search returns nothing | Message is in **your** mailbox; exclusion rules may block the topic |
| Wrong store returned | Repeat with store #, city, and landlord; confirm workspace |
Surfaice does not expand entitlements beyond your existing role in source systems.
## Saving and reviewing work
1. **Review field-by-field** on abstractions, CAM triage, and financial tables.
2. **Save deliberately**, only promote artifacts you accept into workspace memory or export.
3. **Compare to source PDFs** for lease work, especially scanned documents.
4. **Use skills** for repeatable workflows; use freeform chat for exploration. See [Skills](/docs/guides/skills/ai).
## When to contact support
- Persistent access errors after reconnecting connectors
- Organization-wide outage, check [status.surfaice.pro](https://status.surfaice.pro) first
- Security or compliance questionnaires, [security@surfaice.pro](mailto:security@surfaice.pro) and [Trust FAQ](/docs/concepts/trust-faq/ai)
## Related
- [Agent limitations](/docs/concepts/hugo-limitations/ai)
- [Chat with Hugo](/docs/guides/chat-with-hugo/ai)
- [Lease abstraction](/docs/guides/lease-abstraction/ai)