Proof path needed
A reviewer wants credible public evidence quickly. They need the map, the live examples, and the source route without reading every repository.
Scenario
The reviewer problem
The artifact library has several useful entry points. A reviewer needs a fast way to know which source answers the question in front of them and which link should come first.
Source roles can blur
Repository READMEs, wiki pages, operating patterns, and capability indexes can all look like the same kind of proof unless the route names their role.
Review goal
Show where to click first for each reviewer need, what each source proves, and how the portfolio stays public-safe and synthetic.
Source route
Where the inspection starts
Each route card names one source family, its review purpose, and the visible link a reviewer should use. Links are shown as underlined blue text so they read differently from labels and tags.
Synthetic reader input
What different reviewers ask
These inputs are synthetic. They represent common review needs without using employer names, client details, private records, or confidential operating data.
| Reader | Primary question | First source to inspect | Useful proof signal |
|---|---|---|---|
| Recruiter | Where is the quickest credible proof path? | Portfolio Artifact Map | A guided route from portfolio question to public artifact. |
| PMO leader | Where are the governance frameworks and repeatable patterns? | Operating Patterns repository | Generalized operating patterns for portfolio review, intake, decision quality, and follow-through. |
| AI operations reader | Where are reliance boundaries and safe use expectations visible? | Capability Index | Capability-level framing that separates automation support from human accountability. |
| Hiring manager | Where is evidence without confidential details? | Portfolio wiki pages | Curated, public-safe context that connects examples to operating judgment. |
Evidence produced
What the source review creates
The review output should make the library easier to inspect. It gives each source a purpose and keeps the evidence path short.
Reviewer route
- One click-first source for each common reader question.
- Clear difference between repository source, wiki context, capability index, and module example.
- Direct links to the public sources named in the route.
Proof inventory
- Artifact map for discovery.
- Capability index for thematic inspection.
- Operating patterns for governance and review logic.
- Module repositories for runnable or inspectable examples.
Public-safety check
- Synthetic reader inputs.
- No employer, client, system, financial, or private operational records.
- Generalized operating patterns instead of confidential case studies.
Handoff material
- Exact link targets for the landing page, profile repository, and wiki references.
- Review-first language that can be approved before publication.
- A route that can be linked later without changing shared files today.
Final review
Which source answers which question
This table is the review decision aid. It tells a reviewer what each source is for and where to click first.
Review frame
Start with the artifact map when the reviewer needs orientation. Move to the capability index for themes, the operating patterns repository for governance logic, and module repositories when the reviewer wants concrete examples or implementation boundaries.
| Reviewer question | Source that answers it | Where to click first | What the reviewer should expect |
|---|---|---|---|
| How do I navigate the artifact library quickly? | Portfolio Artifact Map | Open the artifact map | A curated source guide that points from review intent to proof artifact. |
| Which capabilities does the portfolio demonstrate? | Capability Index | Open the capability index | A capability-level view across governance, portfolio operations, AI operations, and decision support. |
| Where are the reusable governance patterns? | Operating Patterns repository | Open the operating patterns repository | Public-safe pattern pages and source material for inspecting operating approach. |
| Where can I see concrete modules and examples? | Module repositories | Open Marco's repositories | README files, examples, runtime folders, and boundaries for individual portfolio modules. |
| Where is the curated portfolio context? | Portfolio wiki pages | Open the portfolio wiki | A public-facing explanation layer that connects source artifacts to reviewer needs. |
Repository and source route
Public sources for inspection
These are the source links named in the journey. They are listed together so a reviewer can move from this draft into the public materials without hunting.