Skip to content

Commit 659f047

Browse files
eliasecchigeliasecchig
authored
docs: surface maintenance mode and push users to agents-cli (#967)
* docs: surface maintenance mode and push users to agents-cli Rewrite the README banner to lead with "in maintenance mode — switch to agents-cli" instead of soft-launching the new tool. Add a persistent, prominent banner above the hero on the docs home page and a smaller banner at the top of every documentation page so visitors landing on deep pages also see the migration message. Active development has moved to agents-cli; ASP receives critical fixes only. The existing announcement was easy to miss — this makes the maintenance status unmistakable on both GitHub and the docs site. Also removes the recently-added "copy as markdown" button, which was visually competing with the banner and adds little value now that the docs are no longer a primary development surface. * docs: use semantic aside with role=status for banners
1 parent facbda1 commit 659f047

7 files changed

Lines changed: 253 additions & 89 deletions

File tree

‎README.md‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,24 +15,23 @@
1515
</picture>
1616
</a> [![Launch in Cloud Shell](https://img.shields.io/badge/Launch-in_Cloud_Shell-white)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Feliasecchig%2Fasp-open-in-cloud-shell&cloudshell_print=open-in-cs) ![Stars](https://img.shields.io/github/stars/GoogleCloudPlatform/agent-starter-pack?color=yellow)
1717

18-
> ## 📣 Agents CLI is here
18+
> ## ⚠️ Agent Starter Pack is in maintenance mode — switch to `agents-cli`
1919
>
20-
> **[`agents-cli`](https://github.com/google/agents-cli)** is the next evolution of Agent Starter Pack — the unified CLI and skills for building, evaluating, deploying, and operating agents on Google Cloud's Agent Platform. It works with Claude Code, Gemini CLI, Codex, and any other coding agent.
20+
> **Active development has moved to [`agents-cli`](https://github.com/google/agents-cli)**, the next evolution of Agent Starter Pack. ASP will continue to receive critical fixes only — **no new features, no new templates, no new deployment targets.** New projects should start with `agents-cli`; existing projects should migrate.
2121
>
2222
> ```bash
2323
> uvx google-agents-cli setup
2424
> ```
2525
>
26-
> **Already on ASP? Migration takes minutes** — your agent code, tests, Terraform, and CI/CD all carry over with no rewrites.
26+
> **Migration takes minutes** — your agent code, tests, Terraform, and CI/CD carry over with no rewrites.
2727
>
2828
> **What you gain:**
2929
> - 🛠️ **Unified CLI** in place of the Makefile — `run`, `deploy`, `eval run`, `eval compare`, `playground`, `lint`, and more
3030
> - 🧠 **Bundled coding-agent skills** that turn Claude Code, Gemini CLI, or Codex into an ADK expert
3131
> - 🔁 **End-to-end lifecycle tooling**: scaffold → eval → deploy → publish → observe
32+
> - ☁️ **First-class support** for Google Cloud's Agent Platform
3233
>
3334
> **→ [Migration guide](https://google.github.io/agents-cli/reference/from-agent-starter-pack/)** &nbsp;•&nbsp; [Get started](https://google.github.io/agents-cli/) &nbsp;•&nbsp; [Docs](https://google.github.io/agents-cli/) &nbsp;•&nbsp; [GitHub](https://github.com/google/agents-cli) &nbsp;•&nbsp; [PyPI](https://pypi.org/project/google-agents-cli/)
34-
>
35-
> **Agent Starter Pack will no longer receive new features.** All future development happens in `agents-cli`.
3635
3736
---
3837

‎docs/.vitepress/theme/CopyMarkdown.vue‎

Lines changed: 0 additions & 67 deletions
This file was deleted.

‎docs/.vitepress/theme/HomeHeroBanner.vue‎

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
<template>
2+
<aside class="asp-home-banner" role="status" aria-label="Project status">
3+
<div class="asp-home-banner__inner">
4+
<span class="asp-home-banner__icon" aria-hidden="true">⚠️</span>
5+
<span class="asp-home-banner__text">
6+
<strong>Agent Starter Pack is in maintenance mode.</strong>
7+
Active development has moved to
8+
<a
9+
href="https://github.com/google/agents-cli"
10+
target="_blank"
11+
rel="noopener noreferrer"
12+
><code>agents-cli</code></a>.
13+
ASP receives critical fixes only — no new features.
14+
</span>
15+
<span class="asp-home-banner__actions">
16+
<a
17+
href="https://google.github.io/agents-cli/"
18+
target="_blank"
19+
rel="noopener noreferrer"
20+
class="asp-home-banner__cta"
21+
>Switch now →</a>
22+
<a
23+
href="https://google.github.io/agents-cli/reference/from-agent-starter-pack/"
24+
target="_blank"
25+
rel="noopener noreferrer"
26+
class="asp-home-banner__link"
27+
>Migration guide</a>
28+
</span>
29+
</div>
30+
</aside>
31+
</template>
32+
33+
<script setup></script>
34+
35+
<style scoped>
36+
.asp-home-banner {
37+
max-width: 1152px;
38+
margin: 24px auto 0;
39+
padding: 0 24px;
40+
}
41+
42+
.asp-home-banner__inner {
43+
display: flex;
44+
align-items: center;
45+
flex-wrap: wrap;
46+
gap: 12px 16px;
47+
background: linear-gradient(90deg, #fef3c7 0%, #fde68a 100%);
48+
border: 1px solid #f59e0b;
49+
border-radius: 8px;
50+
padding: 14px 20px;
51+
color: #78350f;
52+
font-size: 14px;
53+
line-height: 1.5;
54+
}
55+
56+
.asp-home-banner__icon {
57+
font-size: 18px;
58+
flex-shrink: 0;
59+
}
60+
61+
.asp-home-banner__text {
62+
flex: 1;
63+
min-width: 280px;
64+
}
65+
66+
.asp-home-banner__text a {
67+
color: #b45309;
68+
text-decoration: underline;
69+
font-weight: 500;
70+
}
71+
72+
.asp-home-banner__text code {
73+
background: rgba(120, 53, 15, 0.08);
74+
padding: 1px 5px;
75+
border-radius: 3px;
76+
font-size: 13px;
77+
}
78+
79+
.asp-home-banner__actions {
80+
display: flex;
81+
align-items: center;
82+
gap: 16px;
83+
flex-shrink: 0;
84+
}
85+
86+
.asp-home-banner__cta {
87+
background: #b45309;
88+
color: #fffbeb !important;
89+
padding: 6px 14px;
90+
border-radius: 6px;
91+
font-weight: 500;
92+
text-decoration: none !important;
93+
white-space: nowrap;
94+
transition: background 0.15s;
95+
}
96+
97+
.asp-home-banner__cta:hover {
98+
background: #78350f;
99+
}
100+
101+
.asp-home-banner__link {
102+
color: #b45309;
103+
text-decoration: underline;
104+
font-weight: 500;
105+
white-space: nowrap;
106+
}
107+
108+
.asp-home-banner__link:hover {
109+
color: #78350f;
110+
}
111+
112+
.dark .asp-home-banner__inner {
113+
background: linear-gradient(90deg, #422006 0%, #78350f 100%);
114+
border-color: #b45309;
115+
color: #fef3c7;
116+
}
117+
118+
.dark .asp-home-banner__text a,
119+
.dark .asp-home-banner__link {
120+
color: #fcd34d;
121+
}
122+
123+
.dark .asp-home-banner__text a:hover,
124+
.dark .asp-home-banner__link:hover {
125+
color: #fef3c7;
126+
}
127+
128+
.dark .asp-home-banner__text code {
129+
background: rgba(254, 243, 199, 0.1);
130+
}
131+
132+
.dark .asp-home-banner__cta {
133+
background: #fcd34d;
134+
color: #422006 !important;
135+
}
136+
137+
.dark .asp-home-banner__cta:hover {
138+
background: #fef3c7;
139+
}
140+
</style>

‎docs/.vitepress/theme/MaintenanceBanner.vue‎

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
<template>
2+
<aside class="asp-maintenance-banner" role="status" aria-label="Project status">
3+
<div class="asp-maintenance-banner__inner">
4+
<span class="asp-maintenance-banner__icon" aria-hidden="true">⚠️</span>
5+
<div class="asp-maintenance-banner__text">
6+
<strong>Agent Starter Pack is in maintenance mode.</strong>
7+
Active development has moved to
8+
<a
9+
href="https://github.com/google/agents-cli"
10+
target="_blank"
11+
rel="noopener noreferrer"
12+
><code>agents-cli</code></a>.
13+
ASP receives critical fixes only — no new features.
14+
<a
15+
href="https://google.github.io/agents-cli/"
16+
target="_blank"
17+
rel="noopener noreferrer"
18+
class="asp-maintenance-banner__cta"
19+
>Switch now →</a>
20+
<a
21+
href="https://google.github.io/agents-cli/reference/from-agent-starter-pack/"
22+
target="_blank"
23+
rel="noopener noreferrer"
24+
>Migration guide</a>
25+
</div>
26+
</div>
27+
</aside>
28+
</template>
29+
30+
<script setup></script>
31+
32+
<style scoped>
33+
.asp-maintenance-banner {
34+
margin: 0 0 24px;
35+
}
36+
37+
.asp-maintenance-banner__inner {
38+
display: flex;
39+
align-items: flex-start;
40+
gap: 12px;
41+
background: linear-gradient(90deg, #fef3c7 0%, #fde68a 100%);
42+
border: 1px solid #f59e0b;
43+
border-radius: 8px;
44+
padding: 12px 16px;
45+
color: #78350f;
46+
font-size: 14px;
47+
line-height: 1.5;
48+
}
49+
50+
.asp-maintenance-banner__icon {
51+
font-size: 16px;
52+
flex-shrink: 0;
53+
line-height: 1.5;
54+
}
55+
56+
.asp-maintenance-banner__text {
57+
flex: 1;
58+
}
59+
60+
.asp-maintenance-banner__text a {
61+
color: #b45309;
62+
text-decoration: underline;
63+
font-weight: 500;
64+
}
65+
66+
.asp-maintenance-banner__text a:hover {
67+
color: #78350f;
68+
}
69+
70+
.asp-maintenance-banner__text code {
71+
background: rgba(120, 53, 15, 0.08);
72+
padding: 1px 5px;
73+
border-radius: 3px;
74+
font-size: 13px;
75+
}
76+
77+
.asp-maintenance-banner__cta {
78+
margin-left: 4px;
79+
font-weight: 600;
80+
}
81+
82+
.dark .asp-maintenance-banner__inner {
83+
background: linear-gradient(90deg, #422006 0%, #78350f 100%);
84+
border-color: #b45309;
85+
color: #fef3c7;
86+
}
87+
88+
.dark .asp-maintenance-banner__text a {
89+
color: #fcd34d;
90+
}
91+
92+
.dark .asp-maintenance-banner__text a:hover {
93+
color: #fef3c7;
94+
}
95+
96+
.dark .asp-maintenance-banner__text code {
97+
background: rgba(254, 243, 199, 0.1);
98+
}
99+
</style>

‎docs/.vitepress/theme/custom.css‎

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎docs/.vitepress/theme/index.js‎

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,14 @@
11
import DefaultTheme from 'vitepress/theme'
2-
import CopyMarkdown from './CopyMarkdown.vue'
3-
import './custom.css'
2+
import MaintenanceBanner from './MaintenanceBanner.vue'
3+
import HomeHeroBanner from './HomeHeroBanner.vue'
44
import { h } from 'vue'
55

66
export default {
77
extends: DefaultTheme,
88
Layout() {
99
return h(DefaultTheme.Layout, null, {
10-
'doc-before': () => h('div', { class: 'copy-markdown-container' }, [
11-
h(CopyMarkdown)
12-
])
10+
'home-hero-before': () => h(HomeHeroBanner),
11+
'doc-before': () => h(MaintenanceBanner)
1312
})
1413
}
1514
}

‎docs/index.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,14 @@ hero:
1111
alt: Agent Starter Pack Logo
1212
actions:
1313
- theme: brand
14-
text: Get Started Guide
15-
link: /guide/getting-started
14+
text: Switch to agents-cli →
15+
link: https://google.github.io/agents-cli/
1616
- theme: alt
17-
text: Development Guide
18-
link: /guide/development-guide
17+
text: Migration Guide
18+
link: https://google.github.io/agents-cli/reference/from-agent-starter-pack/
1919
- theme: alt
20-
text: Watch Demo Video
21-
link: https://www.youtube.com/watch?v=mtJMYgJkTt8
20+
text: Get Started (ASP)
21+
link: /guide/getting-started
2222

2323
features:
2424
- icon: ⚡️

0 commit comments

Comments
 (0)